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

package/README.md

@@ -0,0 +1,90 @@
+# @json_1013/core-geografico-isa-mapa
+
+Mapa de Core ISA (ArcGIS) listo para embeber: el backend de Core ISA describe
+la aplicación (mapas, capas, herramientas) y la librería la muestra igual que
+en Core ISA. Funciona en proyectos React (JS o TS) y sin React (Angular, Vue,
+JS).
+
+## Instalación
+
+```bash
+npm install @json_1013/core-geografico-isa-mapa @arcgis/core
+```
+
+Mientras la librería esté en prueba, sus versiones se publican con el tag `poc`:
+`npm install @json_1013/core-geografico-isa-mapa@poc @arcgis/core`.
+
+En la entrada del proyecto:
+
+```js
+import "@arcgis/core/assets/esri/themes/light/main.css";
+import "@json_1013/core-geografico-isa-mapa/estilos.css";
+```
+
+No hace falta Tailwind ni TypeScript.
+
+## React
+
+```jsx
+import { MapaCoreIsa } from "@json_1013/core-geografico-isa-mapa";
+
+<div style={{ height: 600 }}>
+  <MapaCoreIsa
+    apiBaseUrl="https://back.isa.co"
+    clientId="<id de la aplicación>"
+    urlToken="/api/token-mapa"
+    modo="EMBEDDED"
+    herramientasDeshabilitadas={["three-dimensional"]}
+    onError={(error) => console.error(error)}
+  />
+</div>;
+```
+
+Requiere React 18.3+ o 19.
+
+## Sin React
+
+```js
+import { montarMapa } from "@json_1013/core-geografico-isa-mapa/standalone";
+
+const mapa = montarMapa("#mapa", {
+  apiBaseUrl: "https://back.isa.co",
+  clientId: "<id de la aplicación>",
+  urlToken: "/api/token-mapa",
+});
+// mapa.actualizar({ ... }) · mapa.desmontar()
+```
+
+## Token
+
+El JWT lo emite un controlador del proyecto consumidor:
+
+- La librería llama `POST urlToken` con `{ clientId }` y espera `{ token }`.
+- Alternativa: `getAccessToken(clientId) => Promise<string>`.
+
+**Sin token válido el mapa no carga**: muestra "Sin acceso al mapa" y llama
+`onError` con un `ErrorToken`. Su `motivo` es uno de `sin-configurar`,
+`controlador`, `vacio` o `rechazado`.
+
+## Más
+
+- **Proyección en el navegador:** `proyectarCoordenadas`, `SRIDS_COLOMBIA`, `ejeFueraDeRango`.
+- **Visor con datos propios:** `MapaView`.
+- **Tipos del contrato:** `CodigoHerramienta`, `ConfiguracionAplicacion`, …
+
+Guía completa (contrato del token, CORS, aislamiento de estilos, publicación):
+`docs/libreria-mapa.md` en el repositorio de Core ISA.
+
+## Desarrollo de este paquete
+
+En el monorepo, el paquete también es la app demo del visor:
+
+```bash
+npm run dev:mapa          # demo en http://localhost:5174
+npm run test:mapa         # pruebas
+npm run build:lib:mapa    # build de la librería (dist-lib/)
+```
+
+El demo lee `VITE_API_BASE_URL` (obligatoria) y `VITE_ARCGIS_API_KEY`
+(opcional) de `packages/mapa/.env`. Arquitectura y herramientas:
+`docs/mapas.md`.