termarium 0.1.5 → 0.1.7

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,15 +26,18 @@ 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
 - Globe view with offline Blue Marble terrain colors, daylight shading, city labels, rotating preview, and horizon flip animation
+- Optional horizon and bearing-oriented ground landscape modes
+- Configurable sky orientation: observer view defaults to east on the left and west on the right, with a map-style option
 - Offline low-precision Venus, Mars, Jupiter, and Saturn positions
 - 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
@@ -48,28 +51,17 @@ 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
 ```
 
 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 sky targets
 s       setup location; type on the preset row to search city presets
-x       pointer mode; arrows move the crosshair, hover selects a star
 g       flip between sky and globe
-Tab     next visible constellation
-S-Tab   previous visible constellation
-h       toggle tonight panel
 o       settings panel
-v       city tour
 ?       detailed help
 ```
 
@@ -81,10 +73,24 @@ saved unless you open setup from that preview and confirm it.
 Quick toggles still work, but they are also available in the settings panel:
 
 ```text
+q       quit; exits constellation zoom first
+Esc     clear selected target; quit if nothing is selected
+←/→     switch city preset; rotate longitude in globe view
+↑/↓     adjust latitude in globe view
+space   pause / resume
+[ / ]   jump one hour
+{ / }   jump one day
+r       return to live sky
+x       pointer mode; arrows move the crosshair, hover selects a star
+z       zoom selected constellation
+Tab     next visible constellation
+S-Tab   previous visible constellation
+h       toggle tonight panel
+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
@@ -93,8 +99,12 @@ c       toggle constellation lines
 + / -   adjust limiting magnitude
 ```
 
+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.
 
@@ -107,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/package.json

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