termarium 0.1.6 → 0.1.8

package/NOTICE

@@ -6,8 +6,9 @@ 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:
+International (CC BY-SA 4.0). The filtered file in this repository keeps stars
+needed by Termarium's default bright-sky catalog plus the HIP entries required
+by the bundled Chinese sky-culture line catalog. It stores only these fields:
 
 hip, proper, ra, dec, mag, ci, con
 
@@ -19,6 +20,28 @@ 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 compact Chinese sky-culture figure and line data
+converted from the Stellarium Chinese sky culture.
+
+Source:
+https://github.com/Stellarium/stellarium-skycultures/tree/master/chinese
+
+The Stellarium Chinese sky culture data is licensed under Creative Commons
+Attribution-ShareAlike. Termarium converts its HIP-number figure paths and
+metadata into compact offline CSV files for the optional Chinese sky-culture
+mode.
+
+Termarium also includes compact Chinese star-name and figure-name search
+metadata converted from Celestial Data by Diego Hernangomez.
+
+Source:
+https://github.com/dieghernan/celestial_data
+
+Celestial Data is licensed under the BSD 3-Clause License. Its traditional
+Chinese constellations and star names are derived from Stellarium skycultures;
+Termarium uses them only as compact search names, pinyin, English labels, and
+HIP mappings.
+
 Termarium also includes a converted constellation-line catalog derived from
 ConstellationLines by Marc van der Sluys / hemel.waarnemen.com.
 

package/README.md

@@ -26,6 +26,7 @@ Linux x64, and Windows x64.
 - 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
+- Optional Chinese sky culture with 318 星官 / 二十八宿 figures and traditional Chinese star-name search
 - 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
@@ -36,7 +37,7 @@ Linux x64, and Windows x64.
 - Sun altitude, daylight/twilight state, sunset, and next sunrise
 - First-run city search on the globe, plus setup for custom coordinates and timezone
 - RA/Dec to Alt/Az sky projection for the current observer and time
-- Four themes plus ASCII/Unicode character modes
+- Programmer-friendly selectable themes plus ASCII/Unicode character modes
 - English by default, with in-app Chinese toggle
 
 ## Usage
@@ -50,6 +51,7 @@ 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 --theme tokyo-night
 termarium --time 2026-05-07T14:00:00Z
 ```
 
@@ -88,7 +90,7 @@ v       city tour
 a       toggle animations
 p       toggle planets
 d       toggle deep-sky objects
-T       cycle theme
+T       open theme menu
 u       cycle charset
 t       toggle English / Chinese
 m       toggle moon panel
@@ -97,10 +99,12 @@ c       toggle constellation lines
 + / -   adjust limiting magnitude
 ```
 
-Landscape mode and sky orientation are available from the settings panel.
+Landscape mode, sky orientation, and western / Chinese sky culture are
+available from the settings panel.
 
 Search accepts proper names, curated aliases, HIP/HD-style identifiers, western
-constellation names, Chinese constellation names, planets, and Messier objects.
+constellation names, Chinese sky-culture asterisms, traditional Chinese star
+names, planets, and Messier objects.
 For example, `Tau Ceti`, `τ Ceti`, `天仓五`, `HD 10700`, and `HIP 8102` all
 select the same star.
 
@@ -113,13 +117,15 @@ matched city fills the location fields, then the usual save row applies it.
 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. The bundled world coastline and land data is derived from Natural
-Earth 1:110m public domain vector data, and the bundled globe color texture is
-downsampled from NASA Blue Marble Next Generation July 2004 topography and
-bathymetry imagery. Planet and solar calculations are local approximate
-algorithms based on NASA/JPL and NOAA public reference formulas.
+ConstellationLines data and remains under CC BY 4.0. The Chinese sky-culture
+figures are converted from Stellarium Chinese sky culture data under CC BY-SA,
+with compact search metadata from Celestial Data under BSD-3-Clause. The
+deep-sky catalog is derived from OpenNGC v20260501 and remains under CC BY-SA
+4.0. See `NOTICE` for attribution. The bundled world coastline and land data is
+derived from Natural Earth 1:110m public domain vector data, and the bundled
+globe color texture is downsampled from NASA Blue Marble Next Generation July
+2004 topography and bathymetry imagery. Planet and solar calculations are local
+approximate algorithms based on NASA/JPL and NOAA public reference formulas.
 
 ## Development
 

package/npm/scripts/install.js

@@ -11,6 +11,8 @@ 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 downloadRetries = readPositiveIntegerEnv("TERMARIUM_NPM_DOWNLOAD_RETRIES", 3);
+const downloadStallTimeoutMs = readPositiveIntegerEnv("TERMARIUM_NPM_DOWNLOAD_STALL_TIMEOUT_MS", 60_000);
 
 const targets = {
   "darwin-arm64": {
@@ -63,11 +65,11 @@ async function main() {
 
   try {
     console.log(`termarium: downloading ${asset}`);
-    const archive = await download(archiveUrl);
+    const archive = await download(archiveUrl, { label: asset, progress: true });
     fs.writeFileSync(archivePath, archive);
 
     if (process.env.TERMARIUM_NPM_SKIP_CHECKSUM !== "1") {
-      const checksums = (await download(checksumUrl)).toString("utf8");
+      const checksums = (await download(checksumUrl, { label: "SHA256SUMS" })).toString("utf8");
       verifyChecksum(asset, archive, checksums);
     }
 
@@ -129,7 +131,25 @@ function run(command, args) {
   }
 }
 
-function download(url, redirects = 0) {
+async function download(url, options = {}) {
+  let lastError;
+  for (let attempt = 1; attempt <= downloadRetries; attempt += 1) {
+    try {
+      return await downloadOnce(url, options);
+    } catch (error) {
+      lastError = error;
+      if (attempt >= downloadRetries) {
+        break;
+      }
+      console.error(
+        `termarium: download failed (${error.message}); retrying ${attempt}/${downloadRetries - 1}`
+      );
+    }
+  }
+  throw lastError;
+}
+
+function downloadOnce(url, options = {}, redirects = 0) {
   return new Promise((resolve, reject) => {
     const request = https.get(
       url,
@@ -150,7 +170,9 @@ function download(url, redirects = 0) {
             reject(new Error(`too many redirects while downloading ${url}`));
             return;
           }
-          resolve(download(new URL(response.headers.location, url).toString(), redirects + 1));
+          resolve(
+            downloadOnce(new URL(response.headers.location, url).toString(), options, redirects + 1)
+          );
           return;
         }
 
@@ -161,14 +183,133 @@ function download(url, redirects = 0) {
         }
 
         const chunks = [];
-        response.on("data", (chunk) => chunks.push(chunk));
-        response.on("end", () => resolve(Buffer.concat(chunks)));
+        const progress = createDownloadProgress(options, response.headers["content-length"]);
+        response.on("data", (chunk) => {
+          chunks.push(chunk);
+          progress.update(chunk.length);
+        });
+        response.on("end", () => {
+          progress.finish();
+          resolve(Buffer.concat(chunks));
+        });
       }
     );
+    request.setTimeout(downloadStallTimeoutMs, () => {
+      request.destroy(new Error(`download stalled for more than ${downloadStallTimeoutMs / 1000}s`));
+    });
     request.on("error", reject);
   });
 }
 
+function createDownloadProgress(options, contentLength) {
+  if (!options.progress) {
+    return { update() {}, finish() {} };
+  }
+
+  const label = options.label ?? "download";
+  const total = Number(contentLength);
+  const hasTotal = Number.isFinite(total) && total > 0;
+  const startedAt = Date.now();
+  const useSingleLine = process.stderr.isTTY;
+  const intervalMs = useSingleLine ? 100 : 5_000;
+  let received = 0;
+  let lastRenderAt = 0;
+  let finished = false;
+
+  const render = (force = false) => {
+    if (finished) {
+      return;
+    }
+    const now = Date.now();
+    if (!force && now - lastRenderAt < intervalMs) {
+      return;
+    }
+    lastRenderAt = now;
+
+    const elapsedSeconds = Math.max((now - startedAt) / 1000, 0.001);
+    const speed = received / elapsedSeconds;
+    const receivedText = formatBytes(received);
+    let message;
+
+    if (hasTotal) {
+      const percent = Math.min(received / total, 1);
+      const eta = speed > 0 ? (total - received) / speed : 0;
+      message = [
+        `termarium: ${label}`,
+        formatPercent(percent),
+        progressBar(percent),
+        `${receivedText}/${formatBytes(total)}`,
+        `${formatBytes(speed)}/s`,
+        `ETA ${formatDuration(eta)}`,
+      ].join(" ");
+    } else {
+      message = `termarium: ${label} ${receivedText} ${formatBytes(speed)}/s`;
+    }
+
+    if (useSingleLine) {
+      process.stderr.write(`\r${message}`);
+    } else {
+      console.error(message);
+    }
+  };
+
+  return {
+    update(chunkLength) {
+      received += chunkLength;
+      render(false);
+    },
+    finish() {
+      render(true);
+      finished = true;
+      if (useSingleLine) {
+        process.stderr.write("\n");
+      }
+    },
+  };
+}
+
+function progressBar(percent) {
+  const width = 20;
+  const filled = Math.max(0, Math.min(width, Math.round(percent * width)));
+  return `[${"#".repeat(filled)}${"-".repeat(width - filled)}]`;
+}
+
+function formatPercent(percent) {
+  return `${Math.round(percent * 100).toString().padStart(3, " ")}%`;
+}
+
+function formatBytes(bytes) {
+  const units = ["B", "KiB", "MiB", "GiB"];
+  let value = bytes;
+  let unitIndex = 0;
+  while (value >= 1024 && unitIndex < units.length - 1) {
+    value /= 1024;
+    unitIndex += 1;
+  }
+  const precision = value >= 100 || unitIndex === 0 ? 0 : 1;
+  return `${value.toFixed(precision)} ${units[unitIndex]}`;
+}
+
+function formatDuration(seconds) {
+  if (!Number.isFinite(seconds) || seconds < 0) {
+    return "--";
+  }
+  if (seconds < 60) {
+    return `${Math.ceil(seconds)}s`;
+  }
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = Math.ceil(seconds % 60);
+  return `${minutes}m${remainingSeconds.toString().padStart(2, "0")}s`;
+}
+
+function readPositiveIntegerEnv(name, fallback) {
+  const value = Number(process.env[name]);
+  if (Number.isInteger(value) && value > 0) {
+    return value;
+  }
+  return fallback;
+}
+
 function escapePowerShell(value) {
   return value.replace(/'/g, "''");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termarium",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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",