# Stellarium Web Engine — Third-party assets

This directory contains the vendored Stellarium Web Engine (SWE) runtime and
data assets required by the `cc-planetarium` WordPress plugin.

## Upstream source

- Project: Stellarium Web Engine
- Repository: <https://github.com/Stellarium/stellarium-web-engine>
- Copyright: © 2017-2022 Stellarium Labs SAS / Stellarium Labs SRL and contributors

## License

The Stellarium Web Engine is distributed under the **GNU Affero General Public
License v3 (AGPL-3.0)**, or alternatively under a commercial licence from
Stellarium Labs. This project redistributes the AGPL-licensed build; the full
license text is available in the upstream repository at `LICENSES/GPL-3.0.txt`
and the AGPL conversion notice in `README.rst`.

Users of this WordPress site consequently receive the engine binaries under the
same AGPL-3.0 terms. Rebuilding these assets is documented in
[../../../../../docs/build-stellarium-engine.md](../../../../../docs/build-stellarium-engine.md).

## Contents

| Path | Source in upstream repo | Purpose |
|---|---|---|
| `stellarium-web-engine.js` | `build/stellarium-web-engine.js` | ES6 module, emits `StelWebEngine` factory |
| `stellarium-web-engine.wasm` | `build/stellarium-web-engine.wasm` | Compiled engine (emscripten 1.39.17) |
| `data/` | `data/` | Fonts, shaders, planet textures, symbols |
| `test-skydata/` | `apps/test-skydata/` | Stars, DSO, sky cultures, surveys, landscapes, minor planets |

## Rebuilding

See [../../../../../docs/build-stellarium-engine.md](../../../../../docs/build-stellarium-engine.md)
for the reproducible Docker-based build recipe (emscripten 1.39.17 + SCons).