npm - astro-viewer - Versions diffs - 1.3.0 - Mend

astro-viewer 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (236) hide show

package/README.md +373 -0
package/dist/astroviewer.cjs +13941 -0
package/dist/astroviewer.cjs.map +1 -0
package/dist/astroviewer.js +2 -0
package/dist/astroviewer.js.map +1 -0
package/dist/astroviewer.min.js +2 -0
package/dist/astroviewer.min.js.map +1 -0
package/lib-esm/AstroSphere.d.ts +114 -0
package/lib-esm/AstroSphere.d.ts.map +1 -0
package/lib-esm/AstroSphere.js +679 -0
package/lib-esm/AstroSphere.js.map +1 -0
package/lib-esm/AstroViewer.d.ts +81 -0
package/lib-esm/AstroViewer.d.ts.map +1 -0
package/lib-esm/AstroViewer.js +348 -0
package/lib-esm/AstroViewer.js.map +1 -0
package/lib-esm/Camera.d.ts +74 -0
package/lib-esm/Camera.d.ts.map +1 -0
package/lib-esm/Camera.js +334 -0
package/lib-esm/Camera.js.map +1 -0
package/lib-esm/Config.d.ts +20 -0
package/lib-esm/Config.d.ts.map +1 -0
package/lib-esm/Config.js +32 -0
package/lib-esm/Config.js.map +1 -0
package/lib-esm/Global.d.ts +27 -0
package/lib-esm/Global.d.ts.map +1 -0
package/lib-esm/Global.js +52 -0
package/lib-esm/Global.js.map +1 -0
package/lib-esm/index.d.ts +17 -0
package/lib-esm/index.d.ts.map +1 -0
package/lib-esm/index.js +16 -0
package/lib-esm/index.js.map +1 -0
package/lib-esm/model/AbstractSkyEntity.d.ts +55 -0
package/lib-esm/model/AbstractSkyEntity.d.ts.map +1 -0
package/lib-esm/model/AbstractSkyEntity.js +153 -0
package/lib-esm/model/AbstractSkyEntity.js.map +1 -0
package/lib-esm/model/AstroGL.d.ts +11 -0
package/lib-esm/model/AstroGL.d.ts.map +1 -0
package/lib-esm/model/AstroGL.js +2 -0
package/lib-esm/model/AstroGL.js.map +1 -0
package/lib-esm/model/ColorMaps.d.ts +17 -0
package/lib-esm/model/ColorMaps.d.ts.map +1 -0
package/lib-esm/model/ColorMaps.js +1288 -0
package/lib-esm/model/ColorMaps.js.map +1 -0
package/lib-esm/model/FoV.d.ts +63 -0
package/lib-esm/model/FoV.d.ts.map +1 -0
package/lib-esm/model/FoV.js +275 -0
package/lib-esm/model/FoV.js.map +1 -0
package/lib-esm/model/MetadataColumn.d.ts +50 -0
package/lib-esm/model/MetadataColumn.d.ts.map +1 -0
package/lib-esm/model/MetadataColumn.js +95 -0
package/lib-esm/model/MetadataColumn.js.map +1 -0
package/lib-esm/model/MetadataManager.d.ts +43 -0
package/lib-esm/model/MetadataManager.d.ts.map +1 -0
package/lib-esm/model/MetadataManager.js +117 -0
package/lib-esm/model/MetadataManager.js.map +1 -0
package/lib-esm/model/Point.d.ts +53 -0
package/lib-esm/model/Point.d.ts.map +1 -0
package/lib-esm/model/Point.js +133 -0
package/lib-esm/model/Point.js.map +1 -0
package/lib-esm/model/Point2D.d.ts +9 -0
package/lib-esm/model/Point2D.d.ts.map +1 -0
package/lib-esm/model/Point2D.js +16 -0
package/lib-esm/model/Point2D.js.map +1 -0
package/lib-esm/model/Source.d.ts +34 -0
package/lib-esm/model/Source.d.ts.map +1 -0
package/lib-esm/model/Source.js +63 -0
package/lib-esm/model/Source.js.map +1 -0
package/lib-esm/model/catalogues/CatalogueGL.d.ts +91 -0
package/lib-esm/model/catalogues/CatalogueGL.d.ts.map +1 -0
package/lib-esm/model/catalogues/CatalogueGL.js +614 -0
package/lib-esm/model/catalogues/CatalogueGL.js.map +1 -0
package/lib-esm/model/catalogues/CatalogueProps.d.ts +2 -0
package/lib-esm/model/catalogues/CatalogueProps.d.ts.map +1 -0
package/lib-esm/model/catalogues/CatalogueProps.js +156 -0
package/lib-esm/model/catalogues/CatalogueProps.js.map +1 -0
package/lib-esm/model/footprints/Footprint.d.ts +44 -0
package/lib-esm/model/footprints/Footprint.d.ts.map +1 -0
package/lib-esm/model/footprints/Footprint.js +104 -0
package/lib-esm/model/footprints/Footprint.js.map +1 -0
package/lib-esm/model/footprints/FootprintProps.d.ts +2 -0
package/lib-esm/model/footprints/FootprintProps.d.ts.map +1 -0
package/lib-esm/model/footprints/FootprintProps.js +87 -0
package/lib-esm/model/footprints/FootprintProps.js.map +1 -0
package/lib-esm/model/footprints/FootprintSetGL.d.ts +106 -0
package/lib-esm/model/footprints/FootprintSetGL.d.ts.map +1 -0
package/lib-esm/model/footprints/FootprintSetGL.js +592 -0
package/lib-esm/model/footprints/FootprintSetGL.js.map +1 -0
package/lib-esm/model/grid/EquatorialGrid.d.ts +49 -0
package/lib-esm/model/grid/EquatorialGrid.d.ts.map +1 -0
package/lib-esm/model/grid/EquatorialGrid.js +302 -0
package/lib-esm/model/grid/EquatorialGrid.js.map +1 -0
package/lib-esm/model/grid/GridTextHelper.d.ts +26 -0
package/lib-esm/model/grid/GridTextHelper.d.ts.map +1 -0
package/lib-esm/model/grid/GridTextHelper.js +92 -0
package/lib-esm/model/grid/GridTextHelper.js.map +1 -0
package/lib-esm/model/grid/HealpixGrid.d.ts +49 -0
package/lib-esm/model/grid/HealpixGrid.d.ts.map +1 -0
package/lib-esm/model/grid/HealpixGrid.js +306 -0
package/lib-esm/model/grid/HealpixGrid.js.map +1 -0
package/lib-esm/model/hips/AllSky.d.ts +40 -0
package/lib-esm/model/hips/AllSky.d.ts.map +1 -0
package/lib-esm/model/hips/AllSky.js +232 -0
package/lib-esm/model/hips/AllSky.js.map +1 -0
package/lib-esm/model/hips/AncestorTile.d.ts +38 -0
package/lib-esm/model/hips/AncestorTile.d.ts.map +1 -0
package/lib-esm/model/hips/AncestorTile.js +248 -0
package/lib-esm/model/hips/AncestorTile.js.map +1 -0
package/lib-esm/model/hips/FoVHelper.d.ts +11 -0
package/lib-esm/model/hips/FoVHelper.d.ts.map +1 -0
package/lib-esm/model/hips/FoVHelper.js +107 -0
package/lib-esm/model/hips/FoVHelper.js.map +1 -0
package/lib-esm/model/hips/HiPS.d.ts +47 -0
package/lib-esm/model/hips/HiPS.d.ts.map +1 -0
package/lib-esm/model/hips/HiPS.js +222 -0
package/lib-esm/model/hips/HiPS.js.map +1 -0
package/lib-esm/model/hips/HiPSDescriptor.d.ts +37 -0
package/lib-esm/model/hips/HiPSDescriptor.d.ts.map +1 -0
package/lib-esm/model/hips/HiPSDescriptor.js +132 -0
package/lib-esm/model/hips/HiPSDescriptor.js.map +1 -0
package/lib-esm/model/hips/Tile.d.ts +51 -0
package/lib-esm/model/hips/Tile.d.ts.map +1 -0
package/lib-esm/model/hips/Tile.js +355 -0
package/lib-esm/model/hips/Tile.js.map +1 -0
package/lib-esm/model/hips/TileBuffer.d.ts +39 -0
package/lib-esm/model/hips/TileBuffer.d.ts.map +1 -0
package/lib-esm/model/hips/TileBuffer.js +148 -0
package/lib-esm/model/hips/TileBuffer.js.map +1 -0
package/lib-esm/model/hips/VisibleTilesManager.d.ts +35 -0
package/lib-esm/model/hips/VisibleTilesManager.d.ts.map +1 -0
package/lib-esm/model/hips/VisibleTilesManager.js +160 -0
package/lib-esm/model/hips/VisibleTilesManager.js.map +1 -0
package/lib-esm/model/tap/TapMetadata.d.ts +31 -0
package/lib-esm/model/tap/TapMetadata.d.ts.map +1 -0
package/lib-esm/model/tap/TapMetadata.js +55 -0
package/lib-esm/model/tap/TapMetadata.js.map +1 -0
package/lib-esm/model/tap/TapMetadataList.d.ts +23 -0
package/lib-esm/model/tap/TapMetadataList.d.ts.map +1 -0
package/lib-esm/model/tap/TapMetadataList.js +58 -0
package/lib-esm/model/tap/TapMetadataList.js.map +1 -0
package/lib-esm/model/tap/TapRepo.d.ts +27 -0
package/lib-esm/model/tap/TapRepo.d.ts.map +1 -0
package/lib-esm/model/tap/TapRepo.js +51 -0
package/lib-esm/model/tap/TapRepo.js.map +1 -0
package/lib-esm/services/SesameService.d.ts +14 -0
package/lib-esm/services/SesameService.d.ts.map +1 -0
package/lib-esm/services/SesameService.js +54 -0
package/lib-esm/services/SesameService.js.map +1 -0
package/lib-esm/services/helpers.d.ts +5 -0
package/lib-esm/services/helpers.d.ts.map +1 -0
package/lib-esm/services/helpers.js +16 -0
package/lib-esm/services/helpers.js.map +1 -0
package/lib-esm/services/hipsNodeService.d.ts +7 -0
package/lib-esm/services/hipsNodeService.d.ts.map +1 -0
package/lib-esm/services/hipsNodeService.js +65 -0
package/lib-esm/services/hipsNodeService.js.map +1 -0
package/lib-esm/services/parse-hipslist.d.ts +3 -0
package/lib-esm/services/parse-hipslist.d.ts.map +1 -0
package/lib-esm/services/parse-hipslist.js +25 -0
package/lib-esm/services/parse-hipslist.js.map +1 -0
package/lib-esm/services/queryCatalogueByFoV.d.ts +2 -0
package/lib-esm/services/queryCatalogueByFoV.d.ts.map +1 -0
package/lib-esm/services/queryCatalogueByFoV.js +56 -0
package/lib-esm/services/queryCatalogueByFoV.js.map +1 -0
package/lib-esm/services/queryFootprintSetByFov.d.ts +2 -0
package/lib-esm/services/queryFootprintSetByFov.d.ts.map +1 -0
package/lib-esm/services/queryFootprintSetByFov.js +128 -0
package/lib-esm/services/queryFootprintSetByFov.js.map +1 -0
package/lib-esm/services/tapRepoService.d.ts +2 -0
package/lib-esm/services/tapRepoService.d.ts.map +1 -0
package/lib-esm/services/tapRepoService.js +190 -0
package/lib-esm/services/tapRepoService.js.map +1 -0
package/lib-esm/services/types.d.ts +13 -0
package/lib-esm/services/types.d.ts.map +1 -0
package/lib-esm/services/types.js +2 -0
package/lib-esm/services/types.js.map +1 -0
package/lib-esm/shader/CatalogueShaderProgram.d.ts +35 -0
package/lib-esm/shader/CatalogueShaderProgram.d.ts.map +1 -0
package/lib-esm/shader/CatalogueShaderProgram.js +94 -0
package/lib-esm/shader/CatalogueShaderProgram.js.map +1 -0
package/lib-esm/shader/FootprintShaderProgram.d.ts +31 -0
package/lib-esm/shader/FootprintShaderProgram.d.ts.map +1 -0
package/lib-esm/shader/FootprintShaderProgram.js +86 -0
package/lib-esm/shader/FootprintShaderProgram.js.map +1 -0
package/lib-esm/shader/GridShaderManager.d.ts +6 -0
package/lib-esm/shader/GridShaderManager.d.ts.map +1 -0
package/lib-esm/shader/GridShaderManager.js +29 -0
package/lib-esm/shader/GridShaderManager.js.map +1 -0
package/lib-esm/shader/HiPSShaderProgram.d.ts +54 -0
package/lib-esm/shader/HiPSShaderProgram.d.ts.map +1 -0
package/lib-esm/shader/HiPSShaderProgram.js +257 -0
package/lib-esm/shader/HiPSShaderProgram.js.map +1 -0
package/lib-esm/shader/ShaderManager.d.ts +12 -0
package/lib-esm/shader/ShaderManager.d.ts.map +1 -0
package/lib-esm/shader/ShaderManager.js +344 -0
package/lib-esm/shader/ShaderManager.js.map +1 -0
package/lib-esm/shader/ShaderManagerMutliHiPS.d.ts +12 -0
package/lib-esm/shader/ShaderManagerMutliHiPS.d.ts.map +1 -0
package/lib-esm/shader/ShaderManagerMutliHiPS.js +750 -0
package/lib-esm/shader/ShaderManagerMutliHiPS.js.map +1 -0
package/lib-esm/utils/CoordsType.d.ts +10 -0
package/lib-esm/utils/CoordsType.d.ts.map +1 -0
package/lib-esm/utils/CoordsType.js +12 -0
package/lib-esm/utils/CoordsType.js.map +1 -0
package/lib-esm/utils/FoVUtils.d.ts +46 -0
package/lib-esm/utils/FoVUtils.d.ts.map +1 -0
package/lib-esm/utils/FoVUtils.js +217 -0
package/lib-esm/utils/FoVUtils.js.map +1 -0
package/lib-esm/utils/GeomUtils.d.ts +36 -0
package/lib-esm/utils/GeomUtils.d.ts.map +1 -0
package/lib-esm/utils/GeomUtils.js +267 -0
package/lib-esm/utils/GeomUtils.js.map +1 -0
package/lib-esm/utils/MouseHelper.d.ts +36 -0
package/lib-esm/utils/MouseHelper.d.ts.map +1 -0
package/lib-esm/utils/MouseHelper.js +94 -0
package/lib-esm/utils/MouseHelper.js.map +1 -0
package/lib-esm/utils/PerspectiveMatrixManager.d.ts +11 -0
package/lib-esm/utils/PerspectiveMatrixManager.d.ts.map +1 -0
package/lib-esm/utils/PerspectiveMatrixManager.js +37 -0
package/lib-esm/utils/PerspectiveMatrixManager.js.map +1 -0
package/lib-esm/utils/RayPickingUtils.d.ts +30 -0
package/lib-esm/utils/RayPickingUtils.d.ts.map +1 -0
package/lib-esm/utils/RayPickingUtils.js +112 -0
package/lib-esm/utils/RayPickingUtils.js.map +1 -0
package/lib-esm/utils/STCSParser.d.ts +16 -0
package/lib-esm/utils/STCSParser.d.ts.map +1 -0
package/lib-esm/utils/STCSParser.js +96 -0
package/lib-esm/utils/STCSParser.js.map +1 -0
package/lib-esm/utils/ShaderUtility.d.ts +2 -0
package/lib-esm/utils/ShaderUtility.d.ts.map +1 -0
package/lib-esm/utils/ShaderUtility.js +23 -0
package/lib-esm/utils/ShaderUtility.js.map +1 -0
package/lib-esm/utils/Utils.d.ts +32 -0
package/lib-esm/utils/Utils.d.ts.map +1 -0
package/lib-esm/utils/Utils.js +77 -0
package/lib-esm/utils/Utils.js.map +1 -0
package/package.json +82 -0

package/README.md ADDED Viewed

@@ -0,0 +1,373 @@
+# 🌌 AstroViewer
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![TypeScript](https://img.shields.io/badge/language-TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![WebGL](https://img.shields.io/badge/3D-WebGL-orange.svg)](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API)
+**AstroViewer** is a lightweight 3D engine for **HiPS (Hierarchical Progressive Surveys)** visualisation and exploration, written in **TypeScript** and **WebGL**.
+It powers the next generation of **Astrobrowser** and provides a simple API for embedding 3D HiPS viewers, catalogue overlays, and TAP service interactions in any web project.
+---
+## 📦 Bundles
+AstroViewer builds the following bundles in the `dist/` directory:
+| File | Description |
+|------|--------------|
+| `astroviewer.js` | UMD bundle for browser environments |
+| `astroviewer.min.js` | Minified UMD bundle |
+| `astroviewer.cjs` | CommonJS build for Node.js |
+| `*.map` | Source maps for debugging |
+---
+## 🪐 Quick Start (Browser)
+Copy the bundle into your project and link it in your HTML page:
+```html
+<script src="./javascripts/astroviewer.js"></script>
+```
+Then you can use the global `astroviewer` object directly.
+Here is a minimal example that loads the HiPS survey, activates a TAP service, and displays a source catalogue.
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>AstroViewer Demo</title>
+  <script src="./javascripts/astroviewer.js"></script>
+</head>
+<body onload="run();">
+  <canvas id="astrocanvas"></canvas>
+  <script>
+    let window.AstroAPI = undefined;
+    async function run() {
+      const AC = new astroviewer.AstroViewer();
+      window.AstroAPI = AC;
+      const hipsUrl = "https://alasky.cds.unistra.fr/DSS/DSSColor/";
+      const resp = await fetch(hipsUrl + "properties");
+      const propsText = await resp.text();
+      const desc = new astroviewer.HiPSDescriptor(propsText, new URL(hipsUrl));
+      const insideSphere = false;
+      window.AstroAPI.activateHiPS(desc, insideSphere);
+      window.AstroAPI.run();
+      const tapRepo = await astroviewer.addTAPRepo("https://sky.esa.int/esasky-tap/tap");
+      const catalogue = tapRepo.cataloguesList.find(cat => cat.name === "catalogues.integral_ibis");
+      window.AstroAPI.showCatalogue(catalogue);
+    }
+  </script>
+</body>
+</html>
+```
+---
+## 🧩 Node.js / TypeScript Usage
+You can also use AstroViewer as a Node module:
+```bash
+npm install ./path/to/astro-core
+```
+Then import from your code:
+```ts
+// ESM
+import { AstroViewer, HiPSDescriptor, addTAPRepo } from 'astro-core';
+// or CommonJS
+const { AstroViewer, HiPSDescriptor, addTAPRepo } = require('astro-core');
+```
+---
+## 🧪 Development Web Interface
+AstroViewer includes a development web UI to explore features such as HiPS loading, FoV control, catalogue management, and footprints.
+You need **Node.js ≥ 22** installed.
+Clone this repository and run:
+```bash
+npm run all
+```
+This command will:
+- Compile the TypeScript source
+- Build the bundles
+- Prepare the web testing interface
+- Start a local web server
+You should see something like:
+```
+Starting up http-server, serving public
+http-server version: 14.1.1
+http-server settings:
+CORS: disabled
+Cache: 3600 seconds
+Connection Timeout: 120 seconds
+Directory Listings: visible
+AutoIndex: visible
+Available on:
+  http://127.0.0.1:8080
+  http://10.0.0.184:8080
+Hit CTRL-C to stop the server
+```
+Then open one of the links in your browser (e.g. [http://127.0.0.1:8080](http://127.0.0.1:8080)) to start exploring **AstroViewer**.
+---
+## 🛠️ Build Scripts
+| Command | Description |
+|----------|--------------|
+| `npm run clean` | Remove `dist` and `lib-esm` directories |
+| `npm run dev` | Build in development mode and watch for changes |
+| `npm run prod` | Production build (minified and with source maps) |
+| `npm run web` | Copy bundles and assets into the public folder |
+| `npm run all` | Full build + launch development web UI |
+---
+## 📚 API Overview
+Main exported classes and utilities:
+- `AstroViewer` — main application controller
+- `HiPSDescriptor` — handles HiPS metadata and configuration
+- `FootprintSetGL` — renders observation footprints
+- `CatalogueGL` — renders astronomical catalogues
+- `addTAPRepo()` — loads TAP repositories and metadata
+- `FoV`, `AstroSphere`, `HealpixGridSingleton`, etc. — geometry, camera, and rendering utilities
+---
+---
+## 🔧 API Reference & Usage
+Below is a practical overview of the **most commonly exposed methods** via the UMD global `astroviewer` (browser) or the module exports (Node/ESM).
+> **Note:** The bundles only include what is exported from `src/index.ts`. If your build exposes additional methods, follow the same patterns shown here.
+### Core Lifecycle
+#### `new AstroViewer(options?)`
+Create the viewer controller.
+```js
+// Browser (UMD)
+const AC = new astroviewer.AstroViewer({
+  canvas: document.getElementById('astrocanvas'), // optional; defaults to #astrocanvas
+  antialias: true                                  // optional
+});
+```
+```ts
+// Node/ESM
+import { AstroViewer } from 'astro-core';
+const AC = new AstroViewer();
+```
+#### `run()`
+Start the render loop and event handling.
+```js
+AC.run();
+```
+#### `stop()`
+Stop/pause the render loop.
+```js
+AC.stop();
+```
+---
+### HiPS Datasets
+#### `activateHiPS(descriptor: HiPSDescriptor, insideSphere = false)`
+Activate a HiPS dataset for rendering.
+```js
+const hipsUrl = "https://alasky.cds.unistra.fr/DSS/DSSColor/";
+const props = await (await fetch(hipsUrl + "properties")).text();
+const desc = new astroviewer.HiPSDescriptor(props, new URL(hipsUrl));
+AC.activateHiPS(desc, /* insideSphere */ false);
+```
+#### `toggleInsideSphere()`
+Toggle the point-of-view (outside vs inside the HiPS sphere).
+```js
+AC.toggleInsideSphere();   // outside <-> inside
+```
+---
+### Camera & Navigation
+#### `goto(raDeg: number, decDeg: number, opts?)`
+Fly the camera to a sky coordinate (ICRS). Optional parameters:
+- `fovDeg?: number` – target field of view (angular diameter)
+- `durationMs?: number` – animation duration (default ~1000–1500 ms)
+- `easing?: (t:number)=>number` – custom easing
+```js
+await AC.goto(287.0, 12.5, { fovDeg: 60, durationMs: 1500 });
+```
+---
+### Overlays & Grids
+#### `toggleHealpixGrid()`
+Show/hide the HEALPix grid overlay.
+```js
+AC.toggleHealpixGrid();
+```
+---
+### TAP Repositories & Catalogues
+#### `addTAPRepo(url: string): Promise<TapRepo>`
+Discover capabilities and available datasets (catalogues, footprints, etc.).
+```js
+const tapRepo = await astroviewer.addTAPRepo("https://sky.esa.int/esasky-tap/tap");
+// Explore the lists (names depend on the service)
+console.log(tapRepo.cataloguesList.map(c => c.name));
+console.log(tapRepo.obsList?.map(o => o.name)); // if provided
+```
+#### `showCatalogue(catalogue: CatalogueGL)`
+Render a catalogue from a TAP repository.
+```js
+const cat = tapRepo.cataloguesList.find(c => c.name === "catalogues.integral_ibis");
+AC.showCatalogue(cat);
+```
+#### `hideCatalogue(catalogue: CatalogueGL, isVisible: boolean)`
+Toggle visibility without removing it.
+```js
+AC.hideCatalogue(cat, false);  // hide
+AC.hideCatalogue(cat, true);   // show
+```
+#### `deleteCatalogue(catalogue: CatalogueGL)`
+Remove a catalogue layer completely.
+```js
+AC.deleteCatalogue(cat);
+```
+#### `changeCatalogueColor(catalogue: CatalogueGL, hexColor: string)`
+Change the colour of rendered catalogue points/sources.
+```js
+AC.changeCatalogueColor(cat, "#ff8800");
+```
+---
+### Footprints (Observations)
+The following methods mirror the catalogue API, but for **observation footprints**.
+#### `showFootprintSet(footprintSet: FootprintSetGL)`
+```js
+const footprints = tapRepo.obsList.find(o => o.name === "observations.some_collection");
+AC.showFootprintSet(footprints);
+```
+#### `hideFootprintSet(footprintSet: FootprintSetGL, isVisible: boolean)`
+```js
+AC.hideFootprintSet(footprints, false); // hide
+AC.hideFootprintSet(footprints, true);  // show
+```
+#### `deleteFootprintSet(footprintSet: FootprintSetGL)`
+```js
+AC.deleteFootprintSet(footprints);
+```
+#### `changeFootprintSetColor(footprintSet: FootprintSetGL, hexColor: string)`
+```js
+AC.changeFootprintSetColor(footprints, "#00ffaa");
+```
+---
+### Events & Utilities (if exported)
+Depending on your build, you may also have helpers like:
+#### `on(eventName: string, handler: Function)` / `off(eventName: string, handler: Function)`
+Listen to viewer events (e.g., click on source, pointer move).
+```js
+AC.on?.("pointermove", (info) => {
+  // info.ra, info.dec, info.pixelX, info.pixelY, etc.
+  console.log("Hover:", info);
+});
+```
+#### `getCenterCoords()`
+Return the current ICRS center of the viewport.
+```js
+const { ra, dec } = AC.getCenterCoords?.() ?? { ra: 0, dec: 0 };
+```
+#### `setBackgroundColor(hex: string)`
+```js
+AC.setBackgroundColor?.("#000000");
+```
+> If a method above is not present in your build, it means it’s not exported by `src/index.ts`.
+> To inspect what’s available in the UMD build, open your page and run:
+>
+> ```js
+> console.log(Object.keys(astroviewer));
+> console.log(Object.getOwnPropertyNames(astroviewer.AstroViewer.prototype));
+> ```
+## 📜 License
+This project is released under the **GNU GPL v3** license.
+© 2025 Fabrizio Giordano (fab77)
+---
+## 🔗 Links
+- 🏠 [GitHub Repository](https://github.com/fab77/astro-core)
+- 🪐 [HiPS Standard (IVOA)](https://www.ivoa.net/documents/HiPS/)
+- 🛰️ [ESA Sky TAP Service](https://sky.esa.int/esasky-tap/tap)
+- ✉️ [Report Issues](https://github.com/fab77/astro-core/issues)