@json_1013/core-geografico-isa-mapa 0.1.4-poc → 0.1.5-poc

package/README.md

@@ -1,100 +1,100 @@
-# @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).
-
-## Páginas sin bundler
-
-El paquete incluye `dist-lib/navegador/`, autocontenida. Se copia entera a la página
-(p. ej. `ResourcesISA/core-geografico-isa-mapa/<versión>/`) y se carga con `import()`:
-
-```js
-const { montarMapa } = await import(".../core-geografico-isa-mapa.js");
-const mapa = montarMapa("#mapViewDiv", { apiBaseUrl, clientId, urlToken });
-```
-
-Guía completa: `docs/libreria-mapa.md`, sección 4b.
-
-## Instalación
-
-```bash
-npm install @json_1013/core-geografico-isa-mapa
-```
-
-`@arcgis/core` se instala junto con la librería.
-
-En la entrada del proyecto (incluye el tema de ArcGIS):
-
-```js
-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`.
+# @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).
+
+## Páginas sin bundler
+
+El paquete incluye `dist-lib/navegador/`, autocontenida. Se copia entera a la página
+(p. ej. `ResourcesISA/core-geografico-isa-mapa/<versión>/`) y se carga con `import()`:
+
+```js
+const { montarMapa } = await import(".../core-geografico-isa-mapa.js");
+const mapa = montarMapa("#mapViewDiv", { apiBaseUrl, clientId, urlToken });
+```
+
+Guía completa: `docs/libreria-mapa.md`, sección 4b.
+
+## Instalación
+
+```bash
+npm install @json_1013/core-geografico-isa-mapa
+```
+
+`@arcgis/core` se instala junto con la librería.
+
+En la entrada del proyecto (incluye el tema de ArcGIS):
+
+```js
+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`.