termarium 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Termarium contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,51 @@
+Termarium includes a filtered bright-star subset derived from the HYG Database
+v4.2 by David Nash / Astronomy Nexus.
+
+Source:
+https://codeberg.org/astronexus/hyg
+https://www.astronexus.com/projects/hyg
+
+The HYG Database is licensed under Creative Commons Attribution-ShareAlike 4.0
+International (CC BY-SA 4.0). The filtered file in this repository keeps only
+the fields needed by Termarium:
+
+hip, proper, ra, dec, mag, ci, con
+
+Termarium also includes a small manually curated star-alias index that maps
+common names, Bayer-style labels, HIP/HD-style identifiers, and selected Chinese
+names back to bundled HIP stars for offline search. This alias layer is not an
+authoritative nomenclature catalog; it is a convenience index for the TUI.
+
+Termarium code is licensed under MIT. The bundled star data remains licensed
+under CC BY-SA 4.0.
+
+Termarium also includes a converted constellation-line catalog derived from
+ConstellationLines by Marc van der Sluys / hemel.waarnemen.com.
+
+Source:
+https://github.com/MarcvdSluys/ConstellationLines
+https://zenodo.org/doi/10.5281/zenodo.10397192
+
+The ConstellationLines data is licensed under Creative Commons Attribution 4.0
+International (CC BY 4.0). Termarium converts the source BSC/HR star-number
+paths to HIP-number paths and filters them to the bundled bright-star subset.
+
+Termarium includes a small converted deep-sky catalog derived from OpenNGC
+v20260501 by Mattia Verga and contributors.
+
+Source:
+https://github.com/mattiaverga/OpenNGC
+https://github.com/mattiaverga/OpenNGC/tree/v20260501
+
+OpenNGC is licensed under Creative Commons Attribution-ShareAlike 4.0
+International (CC BY-SA 4.0). Termarium keeps Messier objects, converts RA/Dec
+to decimal hours/degrees, and adds manually curated entries for M40, M45, and
+M102 where the OpenNGC Messier field is intentionally absent or ambiguous.
+
+Termarium's offline planet positions use low-precision orbital elements and
+methods from NASA/JPL Approximate Positions of the Planets:
+https://ssd.jpl.nasa.gov/planets/approx_pos.html
+
+Termarium's offline solar position, sunrise, sunset, and twilight calculations
+follow the public NOAA Solar Calculation Details reference:
+https://gml.noaa.gov/grad/solcalc/calcdetails.html

package/README.md

@@ -0,0 +1,109 @@
+# Termarium 穹顶终端
+
+Termarium is a quiet terminal planetarium. It opens as a full-screen TUI,
+asks for your observing location the first time, then renders a real bright-star
+sky map with constellations, planets, Messier objects, time travel, and a moon
+phase panel.
+
+```bash
+cargo install termarium
+termarium
+```
+
+Or install the prebuilt binary through npm:
+
+```bash
+npm install -g termarium
+termarium
+```
+
+The npm installer currently ships prebuilt binaries for macOS arm64,
+Linux x64, and Windows x64.
+
+## Features
+
+- Full-screen terminal UI built with Rust, Ratatui, and Crossterm
+- Real HYG v4.2 bright-star subset, bundled for offline use
+- 88 western constellation figures from a bundled CC BY 4.0 line catalog
+- Offline Messier deep-sky catalog derived from OpenNGC v20260501
+- Time travel, city tour, alias-aware target search, constellation highlight, and tonight panel
+- Crosshair pointer mode for selecting visible stars directly from the sky map
+- Offline low-precision Venus, Mars, Jupiter, and Saturn positions
+- Sun altitude, daylight/twilight state, sunset, and next sunrise
+- First-run location setup with city presets, custom coordinates, and timezone
+- RA/Dec to Alt/Az sky projection for the current observer and time
+- Four themes plus ASCII/Unicode character modes
+- English by default, with in-app Chinese toggle
+
+## Usage
+
+```bash
+termarium
+termarium setup
+termarium config
+termarium catalog-info
+termarium --lat 31.2304 --lon 121.4737 --name Shanghai
+termarium --lat 31.2304 --lon 121.4737 --name Shanghai --lang zh
+termarium --lat 31.2304 --lon 121.4737 --name Shanghai --tz Asia/Shanghai
+termarium --theme aurora --charset unicode
+termarium --time 2026-05-07T14:00:00Z
+```
+
+Inside the TUI:
+
+```text
+q       quit
+Esc     clear selected target; quit if nothing is selected
+←/→     switch city preset
+space   pause / resume
+[ / ]   jump one hour
+{ / }   jump one day
+r       return to live sky
+/       search targets
+x       pointer mode; arrows move the crosshair, hover selects a star
+Tab     next visible constellation
+S-Tab   previous visible constellation
+h       toggle tonight panel
+o       settings panel
+v       city tour
+s       setup location
+?       detailed help
+```
+
+Quick toggles still work, but they are also available in the settings panel:
+
+```text
+a       toggle animations
+p       toggle planets
+d       toggle deep-sky objects
+T       cycle theme
+u       cycle charset
+t       toggle English / Chinese
+m       toggle moon panel
+l       toggle labels
+c       toggle constellation lines
++ / -   adjust limiting magnitude
+```
+
+Search accepts proper names, curated aliases, HIP/HD-style identifiers, western
+constellation names, Chinese constellation names, planets, and Messier objects.
+For example, `Tau Ceti`, `τ Ceti`, `天仓五`, `HD 10700`, and `HIP 8102` all
+select the same star.
+
+## Data And License
+
+The application code is MIT licensed. The bundled star catalog is a filtered
+subset derived from the HYG Database v4.2 and remains under CC BY-SA 4.0. The
+constellation-line catalog is derived from Marc van der Sluys'
+ConstellationLines data and remains under CC BY 4.0. The deep-sky catalog is
+derived from OpenNGC v20260501 and remains under CC BY-SA 4.0. See `NOTICE` for
+attribution. Planet and solar calculations are local approximate algorithms
+based on NASA/JPL and NOAA public reference formulas.
+
+## Development
+
+```bash
+cargo fmt
+cargo test
+cargo run
+```

package/npm/bin/termarium.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const executable = process.platform === "win32" ? "termarium.exe" : "termarium";
+const bundledBinary =
+  process.env.TERMARIUM_BINARY_PATH ||
+  path.join(__dirname, "..", "vendor", executable);
+
+if (!fs.existsSync(bundledBinary)) {
+  console.error("Termarium binary is missing.");
+  console.error("Try reinstalling with: npm install -g termarium --force");
+  process.exit(1);
+}
+
+const result = spawnSync(bundledBinary, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status ?? 0);

package/npm/scripts/install.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+const childProcess = require("node:child_process");
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const https = require("node:https");
+const os = require("node:os");
+const path = require("node:path");
+
+const packageRoot = path.resolve(__dirname, "..", "..");
+const packageJson = require(path.join(packageRoot, "package.json"));
+const repo = "https://github.com/7b7b7b/termarium";
+const version = packageJson.version;
+
+const targets = {
+  "darwin-arm64": {
+    target: "aarch64-apple-darwin",
+    archive: "tar.gz",
+    binary: "termarium",
+  },
+  "linux-x64": {
+    target: "x86_64-unknown-linux-gnu",
+    archive: "tar.gz",
+    binary: "termarium",
+  },
+  "win32-x64": {
+    target: "x86_64-pc-windows-msvc",
+    archive: "zip",
+    binary: "termarium.exe",
+  },
+};
+
+main().catch((error) => {
+  console.error(`termarium postinstall failed: ${error.message}`);
+  process.exit(1);
+});
+
+async function main() {
+  if (process.env.TERMARIUM_NPM_SKIP_DOWNLOAD === "1") {
+    console.log("termarium: skipped binary download");
+    return;
+  }
+
+  const platformKey = `${process.platform}-${process.arch}`;
+  const selected = targets[platformKey];
+  if (!selected) {
+    throw new Error(
+      `unsupported platform ${platformKey}. Supported platforms: ${Object.keys(targets).join(", ")}`
+    );
+  }
+
+  const asset = `termarium-${selected.target}.${selected.archive}`;
+  const releaseBase = `${repo}/releases/download/v${version}`;
+  const archiveUrl = `${releaseBase}/${asset}`;
+  const checksumUrl = `${releaseBase}/SHA256SUMS`;
+  const vendorDir = path.join(packageRoot, "npm", "vendor");
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "termarium-npm-"));
+  const archivePath = path.join(tmpDir, asset);
+  const extractDir = path.join(tmpDir, "extract");
+
+  fs.mkdirSync(vendorDir, { recursive: true });
+  fs.mkdirSync(extractDir, { recursive: true });
+
+  try {
+    console.log(`termarium: downloading ${asset}`);
+    const archive = await download(archiveUrl);
+    fs.writeFileSync(archivePath, archive);
+
+    if (process.env.TERMARIUM_NPM_SKIP_CHECKSUM !== "1") {
+      const checksums = (await download(checksumUrl)).toString("utf8");
+      verifyChecksum(asset, archive, checksums);
+    }
+
+    extractArchive(archivePath, extractDir, selected.archive);
+
+    const extractedBinary = path.join(extractDir, selected.binary);
+    if (!fs.existsSync(extractedBinary)) {
+      throw new Error(`${selected.binary} was not found in ${asset}`);
+    }
+
+    const installedBinary = path.join(vendorDir, selected.binary);
+    fs.copyFileSync(extractedBinary, installedBinary);
+    if (process.platform !== "win32") {
+      fs.chmodSync(installedBinary, 0o755);
+    }
+    console.log(`termarium: installed ${selected.target} binary`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+function verifyChecksum(asset, archive, checksums) {
+  const line = checksums
+    .split(/\r?\n/)
+    .find((candidate) => candidate.includes(asset));
+  if (!line) {
+    throw new Error(`checksum for ${asset} was not found`);
+  }
+  const expected = line.trim().split(/\s+/)[0].toLowerCase();
+  const actual = crypto.createHash("sha256").update(archive).digest("hex");
+  if (actual !== expected) {
+    throw new Error(`checksum mismatch for ${asset}`);
+  }
+}
+
+function extractArchive(archivePath, extractDir, archive) {
+  if (archive === "tar.gz") {
+    run("tar", ["-xzf", archivePath, "-C", extractDir]);
+    return;
+  }
+  if (archive === "zip") {
+    const command = [
+      "$ErrorActionPreference = 'Stop'",
+      `Expand-Archive -LiteralPath '${escapePowerShell(archivePath)}' -DestinationPath '${escapePowerShell(extractDir)}' -Force`,
+    ].join("; ");
+    run("powershell.exe", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", command]);
+    return;
+  }
+  throw new Error(`unsupported archive type ${archive}`);
+}
+
+function run(command, args) {
+  const result = childProcess.spawnSync(command, args, { stdio: "inherit" });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`${command} exited with status ${result.status}`);
+  }
+}
+
+function download(url, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(
+      url,
+      {
+        headers: {
+          "User-Agent": "termarium-npm-installer",
+        },
+      },
+      (response) => {
+        const status = response.statusCode ?? 0;
+        if ([301, 302, 303, 307, 308].includes(status)) {
+          response.resume();
+          if (!response.headers.location) {
+            reject(new Error(`redirect from ${url} did not include a location`));
+            return;
+          }
+          if (redirects >= 5) {
+            reject(new Error(`too many redirects while downloading ${url}`));
+            return;
+          }
+          resolve(download(new URL(response.headers.location, url).toString(), redirects + 1));
+          return;
+        }
+
+        if (status < 200 || status >= 300) {
+          response.resume();
+          reject(new Error(`download failed for ${url}: HTTP ${status}`));
+          return;
+        }
+
+        const chunks = [];
+        response.on("data", (chunk) => chunks.push(chunk));
+        response.on("end", () => resolve(Buffer.concat(chunks)));
+      }
+    );
+    request.on("error", reject);
+  });
+}
+
+function escapePowerShell(value) {
+  return value.replace(/'/g, "''");
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "termarium",
+  "version": "0.1.1",
+  "description": "Termarium 穹顶终端: a quiet terminal planetarium.",
+  "license": "MIT AND CC-BY-SA-4.0 AND CC-BY-4.0",
+  "homepage": "https://github.com/7b7b7b/termarium#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7b7b7b/termarium.git"
+  },
+  "bugs": {
+    "url": "https://github.com/7b7b7b/termarium/issues"
+  },
+  "bin": {
+    "termarium": "npm/bin/termarium.js"
+  },
+  "scripts": {
+    "postinstall": "node npm/scripts/install.js"
+  },
+  "files": [
+    "npm/bin",
+    "npm/scripts",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "keywords": [
+    "terminal",
+    "tui",
+    "astronomy",
+    "stars",
+    "planetarium"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}