@cerca.red/mapa 0.2.0

package/dist/navegador/webgl.js

@@ -0,0 +1,47 @@
+/**
+ * Si este navegador puede dibujar el mapa.
+ *
+ * ## Por qué se pregunta y no se intenta
+ *
+ * MapLibre 6 **exige WebGL2**. No hay camino alterno por WebGL1: la versión
+ * anterior lo tenía y esta no. Cuando no hay contexto, lo que se ve no es un
+ * error — es un canvas en blanco, sin excepción y sin mensaje, que es la peor
+ * forma de romperse porque parece que el mapa está cargando.
+ *
+ * SDD §13 pide la degradación mapa→lista, y esta función es lo que la hace
+ * posible: se pregunta **antes** de construir nada, y quien pregunta puede
+ * enseñar la lista en vez de un rectángulo vacío.
+ *
+ * El contexto de prueba se libera en el mismo momento. Un navegador tiene un
+ * número pequeño de contextos WebGL simultáneos —del orden de 16—, y dejar
+ * uno colgado por cada comprobación es como se agota el presupuesto de la
+ * pantalla que sí quería dibujar.
+ */
+export function hayWebGL2() {
+    if (typeof document === "undefined")
+        return false;
+    try {
+        const lienzo = document.createElement("canvas");
+        const contexto = lienzo.getContext("webgl2");
+        if (contexto === null)
+            return false;
+        contexto.getExtension("WEBGL_lose_context")?.loseContext();
+        return true;
+    }
+    catch {
+        // Un navegador con WebGL deshabilitado por política puede lanzar en vez
+        // de devolver null. Para el que pregunta es lo mismo: no hay mapa.
+        return false;
+    }
+}
+/** El error que lanza `crearMapa` cuando no hay dónde dibujar. */
+export class SinWebGL2 extends Error {
+    constructor() {
+        super("Este navegador no tiene WebGL2, y MapLibre 6 lo exige sin alternativa. " +
+            "Lo que corresponde aquí es enseñar la lista en vez del mapa (SDD §13): " +
+            "el componente <Mapa> de @cerca.red/mapa-react lo hace con su prop " +
+            "`respaldo`. Se puede preguntar antes con hayWebGL2().");
+        this.name = "SinWebGL2";
+    }
+}
+//# sourceMappingURL=webgl.js.map

package/dist/navegador/webgl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl.js","sourceRoot":"","sources":["../../src/navegador/webgl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,QAAQ,CAAC,YAAY,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,mEAAmE;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;QACE,KAAK,CACH,yEAAyE;YACvE,yEAAyE;YACzE,oEAAoE;YACpE,uDAAuD,CAC1D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF","sourcesContent":["/**\n * Si este navegador puede dibujar el mapa.\n *\n * ## Por qué se pregunta y no se intenta\n *\n * MapLibre 6 **exige WebGL2**. No hay camino alterno por WebGL1: la versión\n * anterior lo tenía y esta no. Cuando no hay contexto, lo que se ve no es un\n * error — es un canvas en blanco, sin excepción y sin mensaje, que es la peor\n * forma de romperse porque parece que el mapa está cargando.\n *\n * SDD §13 pide la degradación mapa→lista, y esta función es lo que la hace\n * posible: se pregunta **antes** de construir nada, y quien pregunta puede\n * enseñar la lista en vez de un rectángulo vacío.\n *\n * El contexto de prueba se libera en el mismo momento. Un navegador tiene un\n * número pequeño de contextos WebGL simultáneos —del orden de 16—, y dejar\n * uno colgado por cada comprobación es como se agota el presupuesto de la\n * pantalla que sí quería dibujar.\n */\nexport function hayWebGL2(): boolean {\n  if (typeof document === \"undefined\") return false;\n\n  try {\n    const lienzo = document.createElement(\"canvas\");\n    const contexto = lienzo.getContext(\"webgl2\");\n    if (contexto === null) return false;\n    contexto.getExtension(\"WEBGL_lose_context\")?.loseContext();\n    return true;\n  } catch {\n    // Un navegador con WebGL deshabilitado por política puede lanzar en vez\n    // de devolver null. Para el que pregunta es lo mismo: no hay mapa.\n    return false;\n  }\n}\n\n/** El error que lanza `crearMapa` cuando no hay dónde dibujar. */\nexport class SinWebGL2 extends Error {\n  constructor() {\n    super(\n      \"Este navegador no tiene WebGL2, y MapLibre 6 lo exige sin alternativa. \" +\n        \"Lo que corresponde aquí es enseñar la lista en vez del mapa (SDD §13): \" +\n        \"el componente <Mapa> de @cerca.red/mapa-react lo hace con su prop \" +\n        \"`respaldo`. Se puede preguntar antes con hayWebGL2().\",\n    );\n    this.name = \"SinWebGL2\";\n  }\n}\n"]}

package/dist/navegador/worker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * De dónde saca MapLibre su Web Worker, y por qué a veces hay que decírselo.
+ *
+ * MapLibre 6 reparte el motor en dos archivos: `maplibre-gl.mjs`, que corre en
+ * el hilo principal, y `maplibre-gl-worker.mjs`, que corre en el worker y
+ * descomprime y teselas y geometrías. El segundo no se importa: se carga por
+ * URL, y esa URL la deduce el primero de su propio `import.meta.url`.
+ *
+ * Ahí está el problema. Un bundler que reescriba `import.meta.url` —Next.js
+ * lo hace, con Turbopack y con webpack— deja al motor deduciendo la URL del
+ * worker a partir de la de la página, y `new Worker(...)` termina pidiendo un
+ * archivo que no existe. Con Vite no pasa, y por eso el mismo paquete pinta el
+ * mapa en `laboratorio/` y no lo pinta bajo Next.
+ *
+ * La salida que da MapLibre es `setWorkerUrl`, que fija `config.WORKER_URL` y
+ * gana sobre la deducción. Esta función es esa salida con nombre en español y
+ * con la única comprobación que hace falta.
+ *
+ * ## Cuándo surte efecto
+ *
+ * Leído en `maplibre-gl@6.8.0/dist/maplibre-gl-dev.mjs`: `workerFactory()`
+ * (línea 2093) lee `config.WORKER_URL` cada vez que se le llama, y solo se le
+ * llama desde `WorkerPool.acquire` (línea 2122) cuando el pool todavía no
+ * tiene workers. El pool es único para toda la página, y `release` solo los
+ * termina cuando no queda ningún mapa vivo.
+ *
+ * O sea: **la URL se fija antes del primer mapa**. Cambiarla con un mapa ya
+ * construido no mueve nada y tampoco avisa. Por eso `crearMapa` acepta
+ * `urlDelWorker` —lo hace en el orden correcto sin que nadie se acuerde— y
+ * esta función suelta existe para la superficie que prefiere fijarla una vez
+ * al arrancar.
+ */
+export declare function fijarUrlDelWorker(url: string): void;

package/dist/navegador/worker.js

@@ -0,0 +1,47 @@
+import { setWorkerUrl } from "maplibre-gl";
+/**
+ * De dónde saca MapLibre su Web Worker, y por qué a veces hay que decírselo.
+ *
+ * MapLibre 6 reparte el motor en dos archivos: `maplibre-gl.mjs`, que corre en
+ * el hilo principal, y `maplibre-gl-worker.mjs`, que corre en el worker y
+ * descomprime y teselas y geometrías. El segundo no se importa: se carga por
+ * URL, y esa URL la deduce el primero de su propio `import.meta.url`.
+ *
+ * Ahí está el problema. Un bundler que reescriba `import.meta.url` —Next.js
+ * lo hace, con Turbopack y con webpack— deja al motor deduciendo la URL del
+ * worker a partir de la de la página, y `new Worker(...)` termina pidiendo un
+ * archivo que no existe. Con Vite no pasa, y por eso el mismo paquete pinta el
+ * mapa en `laboratorio/` y no lo pinta bajo Next.
+ *
+ * La salida que da MapLibre es `setWorkerUrl`, que fija `config.WORKER_URL` y
+ * gana sobre la deducción. Esta función es esa salida con nombre en español y
+ * con la única comprobación que hace falta.
+ *
+ * ## Cuándo surte efecto
+ *
+ * Leído en `maplibre-gl@6.8.0/dist/maplibre-gl-dev.mjs`: `workerFactory()`
+ * (línea 2093) lee `config.WORKER_URL` cada vez que se le llama, y solo se le
+ * llama desde `WorkerPool.acquire` (línea 2122) cuando el pool todavía no
+ * tiene workers. El pool es único para toda la página, y `release` solo los
+ * termina cuando no queda ningún mapa vivo.
+ *
+ * O sea: **la URL se fija antes del primer mapa**. Cambiarla con un mapa ya
+ * construido no mueve nada y tampoco avisa. Por eso `crearMapa` acepta
+ * `urlDelWorker` —lo hace en el orden correcto sin que nadie se acuerde— y
+ * esta función suelta existe para la superficie que prefiere fijarla una vez
+ * al arrancar.
+ */
+export function fijarUrlDelWorker(url) {
+    // Una cadena vacía no es «sin configurar»: MapLibre resuelve
+    // `config.WORKER_URL || defaultWorkerUrl()`, así que caería otra vez en la
+    // deducción por `import.meta.url` — justo lo que esta función existe para
+    // evitar. Quien pase una variable de entorno sin definir se llevaría una
+    // llamada que devuelve sin quejarse y un mapa que no pinta.
+    if (url.trim() === "") {
+        throw new Error("fijarUrlDelWorker: la URL del worker de MapLibre llegó vacía. Con " +
+            "una cadena vacía MapLibre vuelve a deducirla de `import.meta.url`, " +
+            "que es lo que no funciona bajo Next.js.");
+    }
+    setWorkerUrl(url);
+}
+//# sourceMappingURL=worker.js.map

package/dist/navegador/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/navegador/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,6DAA6D;IAC7D,2EAA2E;IAC3E,0EAA0E;IAC1E,yEAAyE;IACzE,4DAA4D;IAC5D,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,qEAAqE;YACrE,yCAAyC,CAC5C,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC","sourcesContent":["import { setWorkerUrl } from \"maplibre-gl\";\n\n/**\n * De dónde saca MapLibre su Web Worker, y por qué a veces hay que decírselo.\n *\n * MapLibre 6 reparte el motor en dos archivos: `maplibre-gl.mjs`, que corre en\n * el hilo principal, y `maplibre-gl-worker.mjs`, que corre en el worker y\n * descomprime y teselas y geometrías. El segundo no se importa: se carga por\n * URL, y esa URL la deduce el primero de su propio `import.meta.url`.\n *\n * Ahí está el problema. Un bundler que reescriba `import.meta.url` —Next.js\n * lo hace, con Turbopack y con webpack— deja al motor deduciendo la URL del\n * worker a partir de la de la página, y `new Worker(...)` termina pidiendo un\n * archivo que no existe. Con Vite no pasa, y por eso el mismo paquete pinta el\n * mapa en `laboratorio/` y no lo pinta bajo Next.\n *\n * La salida que da MapLibre es `setWorkerUrl`, que fija `config.WORKER_URL` y\n * gana sobre la deducción. Esta función es esa salida con nombre en español y\n * con la única comprobación que hace falta.\n *\n * ## Cuándo surte efecto\n *\n * Leído en `maplibre-gl@6.8.0/dist/maplibre-gl-dev.mjs`: `workerFactory()`\n * (línea 2093) lee `config.WORKER_URL` cada vez que se le llama, y solo se le\n * llama desde `WorkerPool.acquire` (línea 2122) cuando el pool todavía no\n * tiene workers. El pool es único para toda la página, y `release` solo los\n * termina cuando no queda ningún mapa vivo.\n *\n * O sea: **la URL se fija antes del primer mapa**. Cambiarla con un mapa ya\n * construido no mueve nada y tampoco avisa. Por eso `crearMapa` acepta\n * `urlDelWorker` —lo hace en el orden correcto sin que nadie se acuerde— y\n * esta función suelta existe para la superficie que prefiere fijarla una vez\n * al arrancar.\n */\nexport function fijarUrlDelWorker(url: string): void {\n  // Una cadena vacía no es «sin configurar»: MapLibre resuelve\n  // `config.WORKER_URL || defaultWorkerUrl()`, así que caería otra vez en la\n  // deducción por `import.meta.url` — justo lo que esta función existe para\n  // evitar. Quien pase una variable de entorno sin definir se llevaría una\n  // llamada que devuelve sin quejarse y un mapa que no pinta.\n  if (url.trim() === \"\") {\n    throw new Error(\n      \"fijarUrlDelWorker: la URL del worker de MapLibre llegó vacía. Con \" +\n        \"una cadena vacía MapLibre vuelve a deducirla de `import.meta.url`, \" +\n        \"que es lo que no funciona bajo Next.js.\",\n    );\n  }\n\n  setWorkerUrl(url);\n}\n"]}

package/dist/paleta.d.ts

@@ -0,0 +1,53 @@
+import type { Tema } from "./estilo.ts";
+/**
+ * Los colores con los que el SDK dibuja **lo de Cerca**: negocios, rutas,
+ * zonas, vehículos, ubicación. Los del mapa base no están aquí — los pone el
+ * sabor de `@cerca.red/mapa-estilos`.
+ *
+ * ## Por qué hay una paleta aquí y no se importa de `packages/ui`
+ *
+ * Porque `cerca-maps` no comparte `packages/ui` con la PWA, igual que la
+ * landing (ADR-021, y ADR-027 lo repite en sus consecuencias «en contra»):
+ * los colores del mapa se declaran otra vez y **pueden divergir**. Está
+ * asumido a sabiendas, con la salida escrita por si duele —publicar los
+ * tokens como paquete—, que es distinto de no haberlo pensado.
+ *
+ * Mientras tanto, esto es un valor por defecto, no una imposición: `crearMapa`
+ * acepta una paleta y la superficie puede pasarle la suya entera o por
+ * partes.
+ *
+ * ## Lo que no se puede negociar: el color no lleva información solo
+ *
+ * CLAUDE.md §1 pide que nada dependa solo del color, y en un mapa eso es más
+ * fácil de incumplir que en un formulario. Por eso los tres énfasis se
+ * distinguen **también por tamaño**, la selección lleva **anillo** además de
+ * color, y una ubicación aproximada se dibuja **como área con borde
+ * discontinuo**, que es una forma distinta y no un tono distinto. Quien
+ * cambie estos valores puede cambiar los colores; los tamaños y las formas
+ * son la accesibilidad.
+ */
+export interface PaletaDelMapa {
+    readonly negocio: string;
+    readonly negocioDestacado: string;
+    readonly negocioAtenuado: string;
+    readonly contornoDePunto: string;
+    readonly seleccion: string;
+    readonly grupo: string;
+    readonly textoDeGrupo: string;
+    readonly ubicacion: string;
+    readonly haloDeUbicacion: string;
+    readonly vehiculo: string;
+    readonly ruta: string;
+    readonly contornoDeRuta: string;
+    readonly rutaAlternativa: string;
+    readonly zona: string;
+    readonly bordeDeZona: string;
+    readonly isocrona: string;
+    readonly imprecision: string;
+    readonly bordeDeImprecision: string;
+    readonly rotulo: string;
+    readonly haloDeRotulo: string;
+}
+export declare const PALETAS_POR_DEFECTO: Readonly<Record<Tema, PaletaDelMapa>>;
+/** La paleta del tema, con lo que la superficie haya querido cambiar encima. */
+export declare function resolverPaleta(tema: Tema, cambios?: Partial<PaletaDelMapa>): PaletaDelMapa;

package/dist/paleta.js

@@ -0,0 +1,53 @@
+const CLARA = {
+    negocio: "#1f6feb",
+    negocioDestacado: "#0b4fc4",
+    negocioAtenuado: "#8ba3c7",
+    contornoDePunto: "#ffffff",
+    seleccion: "#d9480f",
+    grupo: "#1f6feb",
+    textoDeGrupo: "#ffffff",
+    ubicacion: "#0b7285",
+    haloDeUbicacion: "#0b7285",
+    vehiculo: "#087f5b",
+    ruta: "#1f6feb",
+    contornoDeRuta: "#ffffff",
+    rutaAlternativa: "#94a3b8",
+    zona: "#1f6feb",
+    bordeDeZona: "#0b4fc4",
+    isocrona: "#087f5b",
+    imprecision: "#7c4dff",
+    bordeDeImprecision: "#5b2fd6",
+    rotulo: "#1b2431",
+    haloDeRotulo: "#ffffff",
+};
+const OSCURA = {
+    negocio: "#79b8ff",
+    negocioDestacado: "#c9e2ff",
+    negocioAtenuado: "#4a5b74",
+    contornoDePunto: "#0d1117",
+    seleccion: "#ff9f45",
+    grupo: "#79b8ff",
+    textoDeGrupo: "#0d1117",
+    ubicacion: "#63d3e8",
+    haloDeUbicacion: "#63d3e8",
+    vehiculo: "#5fd6a8",
+    ruta: "#79b8ff",
+    contornoDeRuta: "#0d1117",
+    rutaAlternativa: "#55637a",
+    zona: "#79b8ff",
+    bordeDeZona: "#c9e2ff",
+    isocrona: "#5fd6a8",
+    imprecision: "#b39dff",
+    bordeDeImprecision: "#d5c8ff",
+    rotulo: "#e6edf3",
+    haloDeRotulo: "#0d1117",
+};
+export const PALETAS_POR_DEFECTO = {
+    claro: CLARA,
+    oscuro: OSCURA,
+};
+/** La paleta del tema, con lo que la superficie haya querido cambiar encima. */
+export function resolverPaleta(tema, cambios) {
+    return { ...PALETAS_POR_DEFECTO[tema], ...cambios };
+}
+//# sourceMappingURL=paleta.js.map

package/dist/paleta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paleta.js","sourceRoot":"","sources":["../src/paleta.ts"],"names":[],"mappings":"AAoDA,MAAM,KAAK,GAAkB;IAC3B,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,SAAS;IAC1B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,kBAAkB,EAAE,SAAS;IAC7B,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF,MAAM,MAAM,GAAkB;IAC5B,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,SAAS;IAC1B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,kBAAkB,EAAE,SAAS;IAC7B,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAC5B,IAAU,EACV,OAAgC;IAEhC,OAAO,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;AACtD,CAAC","sourcesContent":["import type { Tema } from \"./estilo.ts\";\n\n/**\n * Los colores con los que el SDK dibuja **lo de Cerca**: negocios, rutas,\n * zonas, vehículos, ubicación. Los del mapa base no están aquí — los pone el\n * sabor de `@cerca.red/mapa-estilos`.\n *\n * ## Por qué hay una paleta aquí y no se importa de `packages/ui`\n *\n * Porque `cerca-maps` no comparte `packages/ui` con la PWA, igual que la\n * landing (ADR-021, y ADR-027 lo repite en sus consecuencias «en contra»):\n * los colores del mapa se declaran otra vez y **pueden divergir**. Está\n * asumido a sabiendas, con la salida escrita por si duele —publicar los\n * tokens como paquete—, que es distinto de no haberlo pensado.\n *\n * Mientras tanto, esto es un valor por defecto, no una imposición: `crearMapa`\n * acepta una paleta y la superficie puede pasarle la suya entera o por\n * partes.\n *\n * ## Lo que no se puede negociar: el color no lleva información solo\n *\n * CLAUDE.md §1 pide que nada dependa solo del color, y en un mapa eso es más\n * fácil de incumplir que en un formulario. Por eso los tres énfasis se\n * distinguen **también por tamaño**, la selección lleva **anillo** además de\n * color, y una ubicación aproximada se dibuja **como área con borde\n * discontinuo**, que es una forma distinta y no un tono distinto. Quien\n * cambie estos valores puede cambiar los colores; los tamaños y las formas\n * son la accesibilidad.\n */\nexport interface PaletaDelMapa {\n  readonly negocio: string;\n  readonly negocioDestacado: string;\n  readonly negocioAtenuado: string;\n  readonly contornoDePunto: string;\n  readonly seleccion: string;\n  readonly grupo: string;\n  readonly textoDeGrupo: string;\n  readonly ubicacion: string;\n  readonly haloDeUbicacion: string;\n  readonly vehiculo: string;\n  readonly ruta: string;\n  readonly contornoDeRuta: string;\n  readonly rutaAlternativa: string;\n  readonly zona: string;\n  readonly bordeDeZona: string;\n  readonly isocrona: string;\n  readonly imprecision: string;\n  readonly bordeDeImprecision: string;\n  readonly rotulo: string;\n  readonly haloDeRotulo: string;\n}\n\nconst CLARA: PaletaDelMapa = {\n  negocio: \"#1f6feb\",\n  negocioDestacado: \"#0b4fc4\",\n  negocioAtenuado: \"#8ba3c7\",\n  contornoDePunto: \"#ffffff\",\n  seleccion: \"#d9480f\",\n  grupo: \"#1f6feb\",\n  textoDeGrupo: \"#ffffff\",\n  ubicacion: \"#0b7285\",\n  haloDeUbicacion: \"#0b7285\",\n  vehiculo: \"#087f5b\",\n  ruta: \"#1f6feb\",\n  contornoDeRuta: \"#ffffff\",\n  rutaAlternativa: \"#94a3b8\",\n  zona: \"#1f6feb\",\n  bordeDeZona: \"#0b4fc4\",\n  isocrona: \"#087f5b\",\n  imprecision: \"#7c4dff\",\n  bordeDeImprecision: \"#5b2fd6\",\n  rotulo: \"#1b2431\",\n  haloDeRotulo: \"#ffffff\",\n};\n\nconst OSCURA: PaletaDelMapa = {\n  negocio: \"#79b8ff\",\n  negocioDestacado: \"#c9e2ff\",\n  negocioAtenuado: \"#4a5b74\",\n  contornoDePunto: \"#0d1117\",\n  seleccion: \"#ff9f45\",\n  grupo: \"#79b8ff\",\n  textoDeGrupo: \"#0d1117\",\n  ubicacion: \"#63d3e8\",\n  haloDeUbicacion: \"#63d3e8\",\n  vehiculo: \"#5fd6a8\",\n  ruta: \"#79b8ff\",\n  contornoDeRuta: \"#0d1117\",\n  rutaAlternativa: \"#55637a\",\n  zona: \"#79b8ff\",\n  bordeDeZona: \"#c9e2ff\",\n  isocrona: \"#5fd6a8\",\n  imprecision: \"#b39dff\",\n  bordeDeImprecision: \"#d5c8ff\",\n  rotulo: \"#e6edf3\",\n  haloDeRotulo: \"#0d1117\",\n};\n\nexport const PALETAS_POR_DEFECTO: Readonly<Record<Tema, PaletaDelMapa>> = {\n  claro: CLARA,\n  oscuro: OSCURA,\n};\n\n/** La paleta del tema, con lo que la superficie haya querido cambiar encima. */\nexport function resolverPaleta(\n  tema: Tema,\n  cambios?: Partial<PaletaDelMapa>,\n): PaletaDelMapa {\n  return { ...PALETAS_POR_DEFECTO[tema], ...cambios };\n}\n"]}

package/dist/proyecciones.d.ts

@@ -0,0 +1,160 @@
+import type { Caja, Coordenada, LineaGeoJSON, MultiLineaGeoJSON, MultiPoligonoGeoJSON, PoligonoGeoJSON } from "@cerca.red/geo";
+/**
+ * Las proyecciones cartográficas: lo que este SDK sabe dibujar.
+ *
+ * ## Lo que un `NegocioEnMapa` no es
+ *
+ * **No es un negocio.** No tiene calificación, ni banda de precio, ni
+ * horario, ni categoría, ni si está abierto. Tiene lo que hace falta para
+ * ponerlo en un mapa: dónde va, con qué símbolo, con qué rótulo, con cuánto
+ * énfasis, y si su ubicación está verificada.
+ *
+ * Eso no es minimalismo: es la frontera de ADR-027 puesta en un tipo. Cerca
+ * decide **qué** se muestra; Cerca Maps decide **cómo** se dibuja. Quien tiene
+ * un `FilaResultado` de la API v1 lo traduce a esto antes de entregarlo, y esa
+ * traducción vive en la superficie.
+ *
+ * El ADR también dice cómo muere esta frontera si muere: «no de un salto, sino
+ * por acumulación» — proyecciones que crecen campo a campo hasta ser el
+ * contrato de la API v1 con otro nombre. Así que la pregunta para cada campo
+ * que alguien quiera añadir aquí es una sola: **¿el motor de dibujo lo usa, o
+ * lo usa una decisión de producto?** Colorear un alfiler según la calificación
+ * es lo segundo: la superficie traduce la calificación a un `enfasis` y
+ * entrega eso.
+ */
+/**
+ * Si la ubicación está verificada o es una estimación.
+ *
+ * Es un dato que **decide Cerca** —la PWA ya lo distingue en su contrato y su
+ * tarjeta dice «no se da por exacta una ubicación que nadie verificó»— y que
+ * aquí cambia el dibujo: una aproximada se pinta como **área**, no como
+ * alfiler. Un alfiler afirma un punto; un área afirma una zona, que es lo
+ * único que se sabe. En una lista esa diferencia es una etiqueta que se puede
+ * pasar por alto; en un mapa se ve o no se ve.
+ */
+export type PrecisionDeUbicacion = "exacta" | "aproximada";
+/**
+ * Cuánto pesa un negocio en el dibujo.
+ *
+ * Es el campo al que la superficie traduce lo que quiera destacar —una
+ * calificación alta, un patrocinio, el resultado que el usuario tiene bajo el
+ * dedo en la lista—. El SDK no sabe por qué está destacado, solo lo dibuja
+ * más grande.
+ */
+export type EnfasisEnMapa = "normal" | "atenuado" | "destacado";
+/** Una sede de un negocio: la misma cosa en otro sitio. */
+export interface SedeEnMapa {
+    readonly id: string;
+    readonly ubicacion: Coordenada;
+    readonly rotulo?: string;
+    readonly precision?: PrecisionDeUbicacion;
+}
+/** Un negocio, tal como se dibuja. */
+export interface NegocioEnMapa {
+    readonly id: string;
+    readonly ubicacion: Coordenada;
+    /**
+     * El identificador de un símbolo registrado con `registrarSimbolos`.
+     *
+     * Si no se da, o si el símbolo no está registrado, se dibuja el punto por
+     * defecto. **No se cae**: un mapa sin el icono de peluquería sigue
+     * mostrando dónde está la peluquería, y ese es el fallo correcto.
+     */
+    readonly simbolo?: string;
+    readonly rotulo?: string;
+    readonly enfasis?: EnfasisEnMapa;
+    /** Por defecto `"exacta"`. */
+    readonly precision?: PrecisionDeUbicacion;
+    readonly sedes?: readonly SedeEnMapa[];
+}
+/**
+ * Un agregado calculado por el backend consumidor.
+ *
+ * El SDK no sabe cómo se formó ni qué negocios contiene: solo necesita dónde
+ * dibujarlo, cuántos representa y qué caja debe encuadrar al tocarlo.
+ */
+export interface GrupoEnMapa {
+    readonly id: string;
+    readonly cantidad: number;
+    readonly ubicacion: Coordenada;
+    readonly caja: Caja;
+    readonly rotulo?: string;
+}
+/**
+ * Los dos modos mutuamente excluyentes de resultados.
+ *
+ * Los grupos vienen ya agregados por un servidor. Los negocios son puntos
+ * individuales sobre los que MapLibre conserva su agrupación visual local.
+ */
+export type ResultadosEnMapa = {
+    readonly modo: "grupos";
+    readonly grupos: readonly GrupoEnMapa[];
+} | {
+    readonly modo: "negocios";
+    readonly negocios: readonly NegocioEnMapa[];
+};
+/** Dónde está el usuario, según quien se lo haya preguntado al navegador. */
+export interface UbicacionDeUsuarioEnMapa {
+    readonly ubicacion: Coordenada;
+    /**
+     * El radio de incertidumbre que reportó la fuente, en metros.
+     *
+     * Se dibuja. Un punto azul solo dice «estás aquí»; el mismo punto con su
+     * halo dice además «con este margen», que es la diferencia entre confiar en
+     * una ubicación de GPS y confiar en una triangulada por antenas.
+     */
+    readonly precisionEnMetros?: number;
+    /** Grados desde el norte. Si viene, el símbolo se orienta. */
+    readonly rumbo?: number;
+}
+/** Un vehículo en movimiento: un domiciliario, un transporte. */
+export interface VehiculoEnMapa {
+    readonly id: string;
+    readonly ubicacion: Coordenada;
+    readonly rumbo?: number;
+    readonly simbolo?: string;
+    readonly rotulo?: string;
+}
+/** Una ruta dibujable. */
+export interface RutaEnMapa {
+    readonly id: string;
+    readonly geometria: LineaGeoJSON | MultiLineaGeoJSON;
+    readonly rotulo?: string;
+    /**
+     * La ruta elegida. Se dibuja encima y con más peso; las demás quedan como
+     * alternativas tocables, y tocarlas emite `ruta:eleccion`.
+     *
+     * Si ninguna se marca, la primera es la principal. Si se marcan varias, la
+     * primera marcada gana: dos rutas principales no significan nada y elegir
+     * en silencio es mejor que no dibujar.
+     */
+    readonly principal?: boolean;
+}
+/** Una zona de cobertura: dónde se reparte, dónde se atiende. */
+export interface ZonaEnMapa {
+    readonly id: string;
+    readonly geometria: PoligonoGeoJSON | MultiPoligonoGeoJSON;
+    readonly rotulo?: string;
+    readonly enfasis?: EnfasisEnMapa;
+}
+/** Una banda de isócrona: hasta dónde se llega en `minutos`. */
+export interface BandaDeIsocrona {
+    readonly minutos: number;
+    readonly geometria: PoligonoGeoJSON | MultiPoligonoGeoJSON;
+}
+/**
+ * Un símbolo registrable.
+ *
+ * `sdf` marca las imágenes de campo de distancia con signo, que son las que
+ * se pueden recolorear desde el estilo. Los iconos de Cerca son de trazo, así
+ * que encajan, y eso evita generar una imagen por cada combinación de icono y
+ * estado.
+ */
+export interface SimboloDeMapa {
+    readonly id: string;
+    readonly ancho: number;
+    readonly alto: number;
+    readonly datos: Uint8ClampedArray | Uint8Array;
+    readonly sdf?: boolean;
+    readonly escalaDePixeles?: number;
+}

package/dist/proyecciones.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proyecciones.js.map

package/dist/proyecciones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proyecciones.js","sourceRoot":"","sources":["../src/proyecciones.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Caja,\n  Coordenada,\n  LineaGeoJSON,\n  MultiLineaGeoJSON,\n  MultiPoligonoGeoJSON,\n  PoligonoGeoJSON,\n} from \"@cerca.red/geo\";\n\n/**\n * Las proyecciones cartográficas: lo que este SDK sabe dibujar.\n *\n * ## Lo que un `NegocioEnMapa` no es\n *\n * **No es un negocio.** No tiene calificación, ni banda de precio, ni\n * horario, ni categoría, ni si está abierto. Tiene lo que hace falta para\n * ponerlo en un mapa: dónde va, con qué símbolo, con qué rótulo, con cuánto\n * énfasis, y si su ubicación está verificada.\n *\n * Eso no es minimalismo: es la frontera de ADR-027 puesta en un tipo. Cerca\n * decide **qué** se muestra; Cerca Maps decide **cómo** se dibuja. Quien tiene\n * un `FilaResultado` de la API v1 lo traduce a esto antes de entregarlo, y esa\n * traducción vive en la superficie.\n *\n * El ADR también dice cómo muere esta frontera si muere: «no de un salto, sino\n * por acumulación» — proyecciones que crecen campo a campo hasta ser el\n * contrato de la API v1 con otro nombre. Así que la pregunta para cada campo\n * que alguien quiera añadir aquí es una sola: **¿el motor de dibujo lo usa, o\n * lo usa una decisión de producto?** Colorear un alfiler según la calificación\n * es lo segundo: la superficie traduce la calificación a un `enfasis` y\n * entrega eso.\n */\n\n/**\n * Si la ubicación está verificada o es una estimación.\n *\n * Es un dato que **decide Cerca** —la PWA ya lo distingue en su contrato y su\n * tarjeta dice «no se da por exacta una ubicación que nadie verificó»— y que\n * aquí cambia el dibujo: una aproximada se pinta como **área**, no como\n * alfiler. Un alfiler afirma un punto; un área afirma una zona, que es lo\n * único que se sabe. En una lista esa diferencia es una etiqueta que se puede\n * pasar por alto; en un mapa se ve o no se ve.\n */\nexport type PrecisionDeUbicacion = \"exacta\" | \"aproximada\";\n\n/**\n * Cuánto pesa un negocio en el dibujo.\n *\n * Es el campo al que la superficie traduce lo que quiera destacar —una\n * calificación alta, un patrocinio, el resultado que el usuario tiene bajo el\n * dedo en la lista—. El SDK no sabe por qué está destacado, solo lo dibuja\n * más grande.\n */\nexport type EnfasisEnMapa = \"normal\" | \"atenuado\" | \"destacado\";\n\n/** Una sede de un negocio: la misma cosa en otro sitio. */\nexport interface SedeEnMapa {\n  readonly id: string;\n  readonly ubicacion: Coordenada;\n  readonly rotulo?: string;\n  readonly precision?: PrecisionDeUbicacion;\n}\n\n/** Un negocio, tal como se dibuja. */\nexport interface NegocioEnMapa {\n  readonly id: string;\n  readonly ubicacion: Coordenada;\n  /**\n   * El identificador de un símbolo registrado con `registrarSimbolos`.\n   *\n   * Si no se da, o si el símbolo no está registrado, se dibuja el punto por\n   * defecto. **No se cae**: un mapa sin el icono de peluquería sigue\n   * mostrando dónde está la peluquería, y ese es el fallo correcto.\n   */\n  readonly simbolo?: string;\n  readonly rotulo?: string;\n  readonly enfasis?: EnfasisEnMapa;\n  /** Por defecto `\"exacta\"`. */\n  readonly precision?: PrecisionDeUbicacion;\n  readonly sedes?: readonly SedeEnMapa[];\n}\n\n/**\n * Un agregado calculado por el backend consumidor.\n *\n * El SDK no sabe cómo se formó ni qué negocios contiene: solo necesita dónde\n * dibujarlo, cuántos representa y qué caja debe encuadrar al tocarlo.\n */\nexport interface GrupoEnMapa {\n  readonly id: string;\n  readonly cantidad: number;\n  readonly ubicacion: Coordenada;\n  readonly caja: Caja;\n  readonly rotulo?: string;\n}\n\n/**\n * Los dos modos mutuamente excluyentes de resultados.\n *\n * Los grupos vienen ya agregados por un servidor. Los negocios son puntos\n * individuales sobre los que MapLibre conserva su agrupación visual local.\n */\nexport type ResultadosEnMapa =\n  | {\n      readonly modo: \"grupos\";\n      readonly grupos: readonly GrupoEnMapa[];\n    }\n  | {\n      readonly modo: \"negocios\";\n      readonly negocios: readonly NegocioEnMapa[];\n    };\n\n/** Dónde está el usuario, según quien se lo haya preguntado al navegador. */\nexport interface UbicacionDeUsuarioEnMapa {\n  readonly ubicacion: Coordenada;\n  /**\n   * El radio de incertidumbre que reportó la fuente, en metros.\n   *\n   * Se dibuja. Un punto azul solo dice «estás aquí»; el mismo punto con su\n   * halo dice además «con este margen», que es la diferencia entre confiar en\n   * una ubicación de GPS y confiar en una triangulada por antenas.\n   */\n  readonly precisionEnMetros?: number;\n  /** Grados desde el norte. Si viene, el símbolo se orienta. */\n  readonly rumbo?: number;\n}\n\n/** Un vehículo en movimiento: un domiciliario, un transporte. */\nexport interface VehiculoEnMapa {\n  readonly id: string;\n  readonly ubicacion: Coordenada;\n  readonly rumbo?: number;\n  readonly simbolo?: string;\n  readonly rotulo?: string;\n}\n\n/** Una ruta dibujable. */\nexport interface RutaEnMapa {\n  readonly id: string;\n  readonly geometria: LineaGeoJSON | MultiLineaGeoJSON;\n  readonly rotulo?: string;\n  /**\n   * La ruta elegida. Se dibuja encima y con más peso; las demás quedan como\n   * alternativas tocables, y tocarlas emite `ruta:eleccion`.\n   *\n   * Si ninguna se marca, la primera es la principal. Si se marcan varias, la\n   * primera marcada gana: dos rutas principales no significan nada y elegir\n   * en silencio es mejor que no dibujar.\n   */\n  readonly principal?: boolean;\n}\n\n/** Una zona de cobertura: dónde se reparte, dónde se atiende. */\nexport interface ZonaEnMapa {\n  readonly id: string;\n  readonly geometria: PoligonoGeoJSON | MultiPoligonoGeoJSON;\n  readonly rotulo?: string;\n  readonly enfasis?: EnfasisEnMapa;\n}\n\n/** Una banda de isócrona: hasta dónde se llega en `minutos`. */\nexport interface BandaDeIsocrona {\n  readonly minutos: number;\n  readonly geometria: PoligonoGeoJSON | MultiPoligonoGeoJSON;\n}\n\n/**\n * Un símbolo registrable.\n *\n * `sdf` marca las imágenes de campo de distancia con signo, que son las que\n * se pueden recolorear desde el estilo. Los iconos de Cerca son de trazo, así\n * que encajan, y eso evita generar una imagen por cada combinación de icono y\n * estado.\n */\nexport interface SimboloDeMapa {\n  readonly id: string;\n  readonly ancho: number;\n  readonly alto: number;\n  readonly datos: Uint8ClampedArray | Uint8Array;\n  readonly sdf?: boolean;\n  readonly escalaDePixeles?: number;\n}\n"]}