celestial-chart 0.8.0

package/src/config.js

@@ -0,0 +1,537 @@
+import * as d3 from "./d3.js";
+import { Celestial } from "./core.js";
+import { has, isArray } from "./util.js";
+
+// Central configuration object
+var globalConfig = {};
+
+//Defaults
+var settings = { 
+  width: 0,     // Default width; height is determined by projection
+  projection: "aitoff",  // Map projection used: airy, aitoff, armadillo, august, azimuthalEqualArea, azimuthalEquidistant, baker, berghaus, boggs, bonne, bromley, collignon, craig, craster, cylindricalEqualArea, cylindricalStereographic, eckert1, eckert2, eckert3, eckert4, eckert5, eckert6, eisenlohr, equirectangular, fahey, foucaut, ginzburg4, ginzburg5, ginzburg6, ginzburg8, ginzburg9, gringorten, hammer, hatano, healpix, hill, homolosine, kavrayskiy7, lagrange, larrivee, laskowski, loximuthal, mercator, miller, mollweide, mtFlatPolarParabolic, mtFlatPolarQuartic, mtFlatPolarSinusoidal, naturalEarth, nellHammer, orthographic, patterson, polyconic, rectangularPolyconic, robinson, sinusoidal, stereographic, times, twoPointEquidistant, vanDerGrinten, vanDerGrinten2, vanDerGrinten3, vanDerGrinten4, wagner4, wagner6, wagner7, wiechel, winkel3
+  projectionRatio: null, // Optional override for default projection ratio
+  transform: "equatorial", // Coordinate transformation: equatorial (default), ecliptic, galactic, supergalactic
+  center: null,       // Initial center coordinates in equatorial transformation [hours, degrees, degrees], 
+                      // otherwise [degrees, degrees, degrees], 3rd parameter is orientation, null = default center
+  geopos: null,       // optional initial geographic position [lat,lon] in degrees, overrides center
+  follow: "zenith",   // on which coordinates to center the map, default: zenith, if location enabled, otherwise center
+  orientationfixed: true,  // Keep orientation angle the same as center[2]
+  zoomlevel: null,    // initial zoom level 0...zoomextend; 0|null = default, 1 = 100%, 0 < x <= zoomextend
+  zoomextend: 10,     // maximum zoom level
+  adaptable: true,    // Sizes are increased with higher zoom-levels
+  interactive: true,  // Enable zooming and rotation with mousewheel and dragging
+  disableAnimations: false, // Disable all animations
+  form: false,        // Display settings form
+  location: false,    // Display location settings, deprecated, use formFields
+  // Set visiblity for each group of fields of the form
+  formFields: {"location": true, "general": true, "stars": true, "dsos": true, "constellations": true, "lines": true, "other": true, download: false},
+  advanced: true,     // Display fewer form fields if false
+  daterange: [],      // Calender date range; null: displaydate-+10; [n<100]: displaydate-+n; [yr]: yr-+10; 
+                      // [yr, n<100]: [yr-n, yr+n]; [yr0, yr1]
+  settimezone: true,  // Automatcally set time zone when geolocation changes
+  timezoneid: "",     // Your own TimeZoneDB account id. Empty: no request is made,
+                      // the offset is estimated from longitude. See timezoneResolver.
+  timezoneResolver: null, // (lat, lon, whenSeconds) => Promise<offsetInMinutes>, or null.
+                      // Takes precedence over timezoneid; lets you point at your own
+                      // service instead of sending visitor coordinates to a third party.
+  controls: true,     // Display zoom controls
+  lang: "",           // Global language override for names, any name setting that has the chosen language available
+                      // Default: desig or empty string for designations, other languages as used anywhere else
+  culture: "",        // Constellation lines, default "iau"
+  container: "celestial-map",   // ID of parent element, e.g. div
+  datapath: "data/",  // Path/URL to data files, empty = subfolder 'data'
+  stars: {
+    show: true,    // Show stars
+    limit: 6,      // Show only stars brighter than limit magnitude
+    colors: true,  // Show stars in spectral colors, if not use fill-style
+    style: { fill: "#ffffff", opacity: 1 }, // Default style for stars
+    designation: true, // Show star names (Bayer, Flamsteed, Variable star, Gliese or designation, 
+                       // i.e. whichever of the previous applies first); may vary with culture setting
+    designationType: "desig",  // Which kind of name is displayed as designation (fieldname in starnames.json)
+    designationStyle: { fill: "#ddddbb", font: "11px 'Palatino Linotype', Georgia, Times, 'Times Roman', serif", align: "left", baseline: "top" },
+    designationLimit: 2.5,  // Show only names for stars brighter than nameLimit
+    propername: false,   // Show proper name (if present)
+    propernameType: "name", // Field in starnames.json that contains proper name; may vary with culture setting
+    propernameStyle: { fill: "#ddddbb", font: "13px 'Palatino Linotype', Georgia, Times, 'Times Roman', serif", align: "right", baseline: "bottom" },
+    propernameLimit: 1.5,  // Show proper names for stars brighter than propernameLimit
+    size: 7,       // Scale size (radius) of star circle in pixels
+    exponent: -0.28, // Scale exponent for star size, larger = more linear
+    data: "stars.6.json" // Data source for stellar data
+  },
+  dsos: {
+    show: true,    // Show Deep Space Objects 
+    limit: 6,      // Show only DSOs brighter than limit magnitude
+    colors: true,  // Show DSOs in symbol colors if true, use style setting below if false
+    style: { fill: "#cccccc", stroke: "#cccccc", width: 2, opacity: 1 }, // Default style for dsos
+    names: true,   // Show DSO names
+    namesType: "desig",  // Type of displayed name: desig, name, or 15 different language codes from dsonames.json
+    nameStyle: { fill: "#cccccc", font: "11px 'Lucida Sans Unicode', 'DejaVu Sans', Helvetica, Arial, serif", align: "left", baseline: "bottom" },
+    nameLimit: 4,  // Show only names for DSOs brighter than nameLimit
+    size: null,    // Optional seperate scale size for DSOs, null = stars.size
+    exponent: 1.4, // Scale exponent for DSO size, larger = more non-linear
+    data: "dsos.bright.json",  // Data source for DSOs
+    symbols: {  // DSO symbol styles
+      gg: {shape: "circle", fill: "#ff0000"},                                 // Galaxy cluster
+      g:  {shape: "ellipse", fill: "#ff0000"},                                // Generic galaxy
+      s:  {shape: "ellipse", fill: "#ff0000"},                                // Spiral galaxy
+      s0: {shape: "ellipse", fill: "#ff0000"},                                // Lenticular galaxy
+      sd: {shape: "ellipse", fill: "#ff0000"},                                // Dwarf galaxy
+      e:  {shape: "ellipse", fill: "#ff0000"},                                // Elliptical galaxy
+      i:  {shape: "ellipse", fill: "#ff0000"},                                // Irregular galaxy
+      oc: {shape: "circle", fill: "#ff9900", stroke: "#ff9900", width: 2},    // Open cluster
+      gc: {shape: "circle", fill: "#ff9900"},                                 // Globular cluster
+      en: {shape: "square", fill: "#ff00cc"},                                 // Emission nebula
+      bn: {shape: "square", fill: "#ff00cc"},                                 // Generic bright nebula
+      sfr:{shape: "square", fill: "#cc00ff"},                                 // Star forming region
+      rn: {shape: "square", fill: "#0000ff"},                                 // Reflection nebula
+      pn: {shape: "diamond", fill: "#00cccc"},                                // Planetary nebula 
+      snr:{shape: "diamond", fill: "#ff00cc"},                                // Supernova remnant
+      dn: {shape: "square", fill: "#999999", stroke: "#999999", width: 2},    // Dark nebula 
+      pos:{shape: "marker", fill: "#cccccc", stroke: "#cccccc", width: 1.5}   // Generic marker
+    }
+  },
+  constellations: {
+    show: true,    // Show constellations 
+    names: true,   // Show constellation names 
+    namesType: "desig",   // What kind of name to show (default 3 letter designations) all options: name, desig, 
+                         // lat, en, ar, cn, cz, ee, fi, fr, de, gr, il, it, jp, kr, in, ir, ru, es, tr 
+    nameStyle: { fill:"#cccc99", align: "center", baseline: "middle", opacity:0.8, 
+                 font: ["14px 'Lucida Sans Unicode', 'DejaVu Sans', Helvetica, Arial, sans-serif",  // Different fonts for brighter &
+                        "12px 'Lucida Sans Unicode', 'DejaVu Sans', Helvetica, Arial, sans-serif",  // darker constellations
+                        "11px 'Lucida Sans Unicode', 'DejaVu Sans', Helvetica, Arial, sans-serif"]},
+    lines: true,   // Show constellation lines 
+    lineStyle: { stroke: "#cccccc", width: 1.5, opacity: 0.6 },
+    bounds: false,  // Show constellation boundaries 
+    boundStyle: { stroke: "#ccff00", width: 1.0, opacity: 0.8, dash: [4,4] }
+  },
+  mw: {
+    show: true,    // Show Milky Way as filled polygons 
+    style: { fill: "#ffffff", opacity: "0.15" } // style for each MW-layer (5 on top of each other)
+  },
+  lines: {
+    graticule: { show: true, stroke: "#cccccc", width: 0.6, opacity: 0.8,      // Show graticule lines 
+			// grid values: "outline", "center", or [lat,...] specific position
+      lon: {pos: [], fill: "#eee", font: "10px 'Lucida Sans Unicode', Helvetica, Arial, sans-serif"}, 
+			// grid values: "outline", "center", or [lon,...] specific position
+		  lat: {pos: [], fill: "#eee", font: "10px 'Lucida Sans Unicode', Helvetica, Arial, sans-serif"}},
+    equatorial: { show: true, stroke: "#aaaaaa", width: 1.3, opacity: 0.7 },    // Show equatorial plane 
+    ecliptic: { show: true, stroke: "#66cc66", width: 1.3, opacity: 0.7 },      // Show ecliptic plane 
+    galactic: { show: false, stroke: "#cc6666", width: 1.3, opacity: 0.7 },     // Show galactic plane 
+    supergalactic: { show: false, stroke: "#cc66cc", width: 1.3, opacity: 0.7 } // Show supergalactic plane 
+   //mars: { show: false, stroke:"#cc0000", width:1.3, opacity:.7 }
+  }, // Background style
+  background: { 
+    fill: "#000000", 
+    opacity: 1, 
+    stroke: "#000000", // Outline
+    width: 1.5 
+  }, 
+  horizon: {  //Show horizon marker, if geo-position and date-time is set
+    show: false, 
+    stroke: "#cccccc", // Line
+    width: 1.0, 
+    fill: "#000000", // Area below horizon
+    opacity: 0.4
+  },  
+  daylight: {  //Show approximate state of sky at selected time
+    show: false
+  },
+  planets: {  //Show planet locations, if date-time is set
+    show: false, 
+    // 3-letter designations of all solar system objects that should be displayed
+    which: ["sol", "mer", "ven", "ter", "lun", "mar", "jup", "sat", "ura", "nep", "cer", "plu"],
+    // Symbols as unicode codepoints, letter abbreviations and colors to be displayed
+    symbols: {
+      "sol": {symbol: "\u2609", letter:"Su", fill: "#ffff00", size: 12},
+      "mer": {symbol: "\u263f", letter:"Me", fill: "#cccccc"},
+      "ven": {symbol: "\u2640", letter:"V", fill: "#eeeecc"},
+      "ter": {symbol: "\u2295", letter:"T", fill: "#00ccff"},
+      "lun": {symbol: "\u25cf", letter:"L", fill: "#ffffff", size: 12},
+      "mar": {symbol: "\u2642", letter:"Ma", fill: "#ff6600"},
+      "cer": {symbol: "\u26b3", letter:"C", fill: "#cccccc"},
+      "ves": {symbol: "\u26b6", letter:"Ma", fill: "#cccccc"},
+      "jup": {symbol: "\u2643", letter:"J", fill: "#ffaa33"},
+      "sat": {symbol: "\u2644", letter:"Sa", fill: "#ffdd66"},
+      "ura": {symbol: "\u2645", letter:"U", fill: "#66ccff"},
+      "nep": {symbol: "\u2646", letter:"N", fill: "#6666ff"},
+      "plu": {symbol: "\u2647", letter:"P", fill: "#aaaaaa"},
+      "eri": {symbol: "\u26aa", letter:"E", fill: "#eeeeee"}
+    },
+    // Style options for planetary symbols
+    symbolStyle: { fill: "#cccccc", opacity:1, font: "bold 20px 'DejaVu Sans Mono', 'Arial Unicode MS', sans-serif", align: "center", baseline: "middle" },
+    symbolType: "symbol",  // Type of planetary symbol to be displayed: 'symbol', 'letter' or 'disk'
+    names: false,  // Show name next to symbol
+    // Style options for planetary names
+    nameStyle: { fill: "#cccccc", font: "14px 'Lucida Sans Unicode', 'DejaVu Sans', sans-serif", align: "right", baseline: "top" },
+    namesType: "en"  // Language in which the name is displayed, options desig, ar, cn, en, fr, de, gr, il, in, it, jp, lat, ru, es
+  },
+  // The `base` parameter is what makes instances possible: without it every
+  // call started from the module-level globalConfig, so a second map inherited
+  // the first one's settings (upstream #96, #131). Given a base, it starts from
+  // that and does not write back to the global either — so two maps cannot see
+  // into each other's configuration. Without a base the original behaviour
+  // stands, so that Celestial.settings() keeps working.
+  set: function(cfg, base) {  // Override defaults with values of cfg
+    var prop, key, config = {}, res = {};
+    if (base) Object.assign(config, base);
+    else if (Object.entries(globalConfig).length === 0) Object.assign(config, this);
+    else Object.assign(config, globalConfig);
+    if (!cfg) return config; 
+    for (prop in config) {
+      if (!has(config, prop)) continue; 
+      //if (typeof(config[prop]) === 'function'); 
+      if (!has(cfg, prop) || cfg[prop] === null) { 
+        res[prop] = config[prop]; 
+      } else if (config[prop] === null || config[prop].constructor != Object ) {
+        res[prop] = cfg[prop];
+      } else {
+        res[prop] = {};
+        for (key in config[prop]) {
+          if (has(cfg[prop], key)) {
+            res[prop][key] = cfg[prop][key];
+          } else {
+            res[prop][key] = config[prop][key];
+          }            
+        }
+      }
+    }
+    res.constellations.nameStyle.font = arrayfy(res.constellations.nameStyle.font);
+    res.constellations.nameStyle.opacity = arrayfy(res.constellations.nameStyle.opacity);
+    res.constellations.nameStyle.fill = arrayfy(res.constellations.nameStyle.fill);
+    res.constellations.lineStyle.width = arrayfy(res.constellations.lineStyle.width);
+    res.constellations.lineStyle.opacity = arrayfy(res.constellations.lineStyle.opacity);
+    res.constellations.lineStyle.stroke = arrayfy(res.constellations.lineStyle.stroke);
+    
+    if (!base) Object.assign(globalConfig, res);
+    return res;
+  },
+  applyDefaults: function(cfg, base) {
+    var res = {};
+    // In the chain this is called on the result of set(), so `this` is the
+    // already-merged configuration. The standalone branch has to continue from
+    // there — starting from globalConfig would discard the caller's settings.
+    Object.assign(res, base ? this : globalConfig);
+    // Nothing works without these
+    res.stars.size = res.stars.size || 7;  
+    res.stars.exponent = res.stars.exponent || -0.28;
+    if (!res.center || res.center.length <= 0) res.center = [0,0,0];
+    res.datapath = res.datapath || "";
+    res.datapath = res.datapath.replace(/([^\/]$)/, "$1\/");
+    if (!res.transform || res.transform === "") res.transform = "equatorial";
+    // If no recognized language/culture settings, assume defaults
+    //if (!res.lang || res.lang.search(/^de|es$/) === -1) res.lang = "name";
+    //Set all poss. names to cfg.lang if not english
+    if (!res.culture || res.culture.search(/^cn$/) === -1) res.culture = "iau";
+
+    if (cfg) {
+      // Adapt legacy name parameters
+      if (has(cfg, "stars")) {
+        // names -> designation
+        if (has(cfg.stars, "names")) res.stars.designation = cfg.stars.names;
+        if (has(cfg.stars, "namelimit")) res.stars.designationLimit = cfg.stars.namelimit;
+        if (has(cfg.stars, "namestyle")) Object.assign(res.stars.designationStyle, cfg.stars.namestyle);    
+        // proper -> propername
+        if (has(cfg.stars, "proper")) res.stars.propername = cfg.stars.proper;
+        if (has(cfg.stars, "propernamelimit")) res.stars.propernameLimit = cfg.stars.propernamelimit;
+        if (has(cfg.stars, "propernamestyle")) Object.assign(res.stars.propernameStyle, cfg.stars.propernamestyle);
+      }
+
+      if (has(cfg, "dsos")) {
+        // names, desig -> namesType
+        //if (has(cfg.dsos, "names") && cfg.dsos.names === true) res.dsos.namesType = "name";
+        if (has(cfg.dsos, "desig") && cfg.dsos.desig === true) res.dsos.namesType = "desig";
+        if (has(cfg.dsos, "namelimit")) res.dsos.nameLimit = cfg.dsos.namelimit;
+        if (has(cfg.dsos, "namestyle")) Object.assign(res.dsos.nameStyle, cfg.dsos.namestyle);    
+      }
+      
+      if (has(cfg, "constellations")) {
+        // names, desig -> namesType
+        if (has(cfg.constellations, "show") && cfg.constellations.show === true) res.constellations.names = true;
+        //if (has(cfg.constellations, "names") && cfg.constellations.names === true) res.constellations.namesType = "name";
+        if (has(cfg.constellations, "desig") && cfg.constellations.desig === true) res.constellations.namesType = "desig";
+        if (res.constellations.namesType === "latin") res.constellations.namesType = "la";
+        if (res.constellations.namesType === "iau") res.constellations.namesType = "name";
+        if (has(cfg.constellations, "namestyle")) Object.assign(res.constellations.nameStyle, cfg.constellations.namestyle);
+        if (has(cfg.constellations, "linestyle")) Object.assign(res.constellations.lineStyle, cfg.constellations.linestyle);
+        if (has(cfg.constellations, "boundstyle")) Object.assign(res.constellations.boundStyle, cfg.constellations.boundstyle);
+      }
+
+      if (has(cfg, "planets")) {
+        if (has(cfg.planets, "style")) Object.assign(res.planets.style, cfg.planets.symbolStyle);      
+      }
+    }
+    //Assign default name types if none given
+    if (!res.stars.designationType || res.stars.designationType === "") res.stars.designationType = "desig";
+    if (!has(formats.starnames[res.culture].designation, res.stars.designationType)) res.designationType = "desig";
+    if (!res.stars.propernameType || res.stars.propernameType === "") res.stars.propernameType = "name";
+    if (!has(formats.starnames[res.culture].propername, res.stars.propernameType)) res.propernameType = "name";
+    if (!res.dsos.namesType || res.dsos.namesType === "") res.dsos.namesType = "desig";
+    if (!res.constellations.namesType || res.constellations.namesType === "") res.constellations.namesType = "desig";
+    if (!has(formats.constellations[res.culture].names, res.constellations.namesType)) res.constellations.namesType = "name";
+    if (!res.planets.symbolType || res.planets.symbolType === "") res.planets.symbolType = "symbol";
+    if (!res.planets.namesType || res.planets.namesType === "") res.planets.namesType = "desig";
+    if (!has(formats.planets[res.culture].names, res.planets.namesType)) res.planets.namesType = "desig";
+    //Expand all parameters that can be arrays into arrays, no need to test it later
+    res.constellations.nameStyle.font = arrayfy(res.constellations.nameStyle.font);
+    res.constellations.nameStyle.opacity = arrayfy(res.constellations.nameStyle.opacity);
+    res.constellations.nameStyle.fill = arrayfy(res.constellations.nameStyle.fill);
+    res.constellations.lineStyle.width = arrayfy(res.constellations.lineStyle.width);
+    res.constellations.lineStyle.opacity = arrayfy(res.constellations.lineStyle.opacity);
+    res.constellations.lineStyle.stroke = arrayfy(res.constellations.lineStyle.stroke);
+
+    if (!base) Object.assign(globalConfig, res);
+    return res; 
+  }
+};
+
+function arrayfy(o) {
+  var res;
+  if (!isArray(o)) return [o, o, o];  //It saves some work later, OK?
+  if (o.length >= 3) return o;
+  if (o.length === 1) return [o[0], o[0], o[0]];
+  if (o.length === 2) return [o[0], o[1], o[1]];
+}
+
+Celestial.settings = function () { return settings; };
+
+//b-v color index to rgb color value scale
+// The v3 quantize scale coped with a descending domain; v4+ runs bisect over
+// the thresholds, which is only correct in ascending order — with the domain
+// [3.347, -0.335] every star turned red. An ascending domain with a reversed
+// range gives the same mapping. svg.js's star-colour loop uses the two ends of
+// domain(), so the order dependence had to be removed there separately —
+// otherwise the reversal would stop that loop from running at all.
+var bvcolor = d3.scaleQuantize().domain([-0.335, 3.347]) //main sequence <= 1.7
+    .range([ '#ff4700', '#ff4b00', '#ff4f00', '#ff5300', '#ff5600', '#ff5900', '#ff5b00', '#ff5d00', '#ff6000', '#ff6300', '#ff6500', '#ff6700', '#ff6900', '#ff6b00', '#ff6d00', '#ff7000', '#ff7300', '#ff7500', '#ff7800', '#ff7a00', '#ff7c00', '#ff7e00', '#ff8100', '#ff8300', '#ff8506', '#ff870a', '#ff8912', '#ff8b1a', '#ff8e21', '#ff9127', '#ff932c', '#ff9631', '#ff9836', '#ff9a3c', '#ff9d3f', '#ffa148', '#ffa34b', '#ffa54f', '#ffa753', '#ffa957', '#ffab5a', '#ffad5e', '#ffb165', '#ffb269', '#ffb46b', '#ffb872', '#ffb975', '#ffbb78', '#ffbe7e', '#ffc184', '#ffc489', '#ffc78f', '#ffc892', '#ffc994', '#ffcc99', '#ffce9f', '#ffd1a3', '#ffd3a8', '#ffd5ad', '#ffd7b1', '#ffd9b6', '#ffdbba', '#ffddbe', '#ffdfc2', '#ffe1c6', '#ffe3ca', '#ffe4ce', '#ffe8d5', '#ffe9d9', '#ffebdc', '#ffece0', '#ffefe6', '#fff0e9', '#fff2ec', '#fff4f2', '#fff5f5', '#fff6f8', '#fff9fd', '#fef9ff', '#f9f6ff', '#f6f4ff', '#f3f2ff', '#eff0ff', '#ebeeff', '#e9edff', '#e6ebff', '#e3e9ff', '#e0e7ff', '#dee6ff', '#dce5ff', '#d9e3ff', '#d7e2ff', '#d3e0ff', '#c9d9ff', '#bfd3ff', '#b7ceff', '#afc9ff', '#a9c5ff', '#a4c2ff', '#9fbfff', '#9bbcff'].reverse());
+ 
+/* Default parameters for each supported projection
+     arg: constructor argument, if any 
+     scale: scale parameter so that they all have ~equal width, normalized to 1024 pixels
+     ratio: width/height ratio, 2.0 if none
+     clip: projection clipped to 90 degrees from center, otherwise to antimeridian
+*/
+var projections = {
+  "airy": {n:"Airy’s Minimum Error", arg:Math.PI/2, scale:360, ratio:1.0, clip:true},
+  "aitoff": {n:"Aitoff", arg:null, scale:162},
+  "armadillo": {n:"Armadillo", arg:0, scale:250}, 
+  "august": {n:"August", arg:null, scale:94, ratio:1.4},
+  "azimuthalEqualArea": {n:"Azimuthal Equal Area", arg:null, scale:340, ratio:1.0, clip:true},
+  "azimuthalEquidistant": {n:"Azimuthal Equidistant", arg:null, scale:320, ratio:1.0, clip:true},
+  "baker": {n:"Baker Dinomic", arg:null, scale:160, ratio:1.4},
+  "berghaus": {n:"Berghaus Star", arg:0, scale:320, ratio:1.0, clip:true},
+  "boggs": {n:"Boggs Eumorphic", arg:null, scale:170},
+  "bonne": {n:"Bonne", arg:Math.PI/2.5, scale:225, ratio:0.88},
+  "bromley": {n:"Bromley", arg:null, scale:162},
+//  "butterfly": {n:"Butterfly", arg:null, scale:31, ratio:1.1, clip:true},
+  "cassini": {n:"Cassini", arg:null, scale:325, ratio:1.0, clip:true},
+  "collignon": {n:"Collignon", arg:null, scale:100, ratio:2.6},
+  "craig": {n:"Craig Retroazimuthal", arg:0, scale:310, ratio:1.5, clip:true},
+  "craster": {n:"Craster Parabolic", arg:null, scale:160},
+  "cylindricalEqualArea": {n:"Cylindrical Equal Area", arg:Math.PI/6, scale:190, ratio:2.3},
+  "cylindricalStereographic": {n:"Cylindrical Stereographic", arg:Math.PI/4, scale:230, ratio:1.3},
+  "eckert1": {n:"Eckert I", arg:null, scale:175},
+  "eckert2": {n:"Eckert II", arg:null, scale:175},
+  "eckert3": {n:"Eckert III", arg:null, scale:190},
+  "eckert4": {n:"Eckert IV", arg:null, scale:190},
+  "eckert5": {n:"Eckert V", arg:null, scale:182},
+  "eckert6": {n:"Eckert VI", arg:null, scale:182},
+  "eisenlohr": {n:"Eisenlohr", arg:null, scale:102},
+  "equirectangular": {n:"Equirectangular", arg:null, scale:165},
+  "fahey": {n:"Fahey", arg:null, scale:196, ratio:1.4},
+  "mtFlatPolarParabolic": {n:"Flat Polar Parabolic", arg:null, scale:175},
+  "mtFlatPolarQuartic": {n:"Flat Polar Quartic", arg:null, scale:230, ratio:1.65},
+  "mtFlatPolarSinusoidal": {n:"Flat Polar Sinusoidal", arg:null, scale:175, ratio:1.9},
+  "foucaut": {n:"Foucaut", arg:null, scale:142},
+  "ginzburg4": {n:"Ginzburg IV", arg:null, scale:180, ratio:1.7},
+  "ginzburg5": {n:"Ginzburg V", arg:null, scale:196, ratio:1.55},
+  "ginzburg6": {n:"Ginzburg VI", arg:null, scale:190, ratio:1.4},
+  "ginzburg8": {n:"Ginzburg VIII", arg:null, scale:205, ratio:1.3},
+  "ginzburg9": {n:"Ginzburg IX", arg:null, scale:190, ratio:1.4},
+  //"guyou": {n:"Guyou", arg:null, scale:160, ratio:2, clip:true},
+  //"bonne": {n:"Heart", arg:Math.PI/2.5, scale:225, ratio:0.88},
+  "homolosine": {n:"Goode Homolosine", arg:null, scale:160, ratio:2.2},
+  "hammer": {n:"Hammer", arg:2, scale:180},
+  "hatano": {n:"Hatano", arg:null, scale:186},
+  "healpix": {n:"HEALPix", arg:1, scale:320, ratio:1.2},
+  "hill": {n:"Hill Eucyclic", arg:2, scale:190, ratio:1.1},
+  "kavrayskiy7": {n:"Kavrayskiy VII", arg:null, scale:185, ratio:1.75},
+  "lagrange": {n:"Lagrange", arg:Math.PI/4, scale:88, ratio:1.6, clip:false},
+  "larrivee": {n:"l'Arrivée", arg:null, scale:160, ratio:1.25},
+  "laskowski": {n:"Laskowski Tri-Optimal", arg:null, scale:165, ratio:1.7},
+  "loximuthal": {n:"Loximuthal", arg:Math.PI/4, scale:175, ratio:1.8},
+  "mercator": {n:"Mercator", arg:null, scale:160, ratio:1.3},
+  "miller": {n:"Miller", arg:null, scale:160, ratio:1.5},
+  "mollweide": {n:"Mollweide", arg:null, scale:180},
+  "naturalEarth": {n:"Natural Earth", arg:null, scale:185, ratio:1.85},
+  "nellHammer": {n:"Nell Hammer", arg:null, scale:160, ratio:2.6},
+  "orthographic": {n:"Orthographic", arg:null, scale:480, ratio:1.0, clip:true},
+  "patterson": {n:"Patterson Cylindrical", arg:null, scale:160, ratio:1.75},
+  "polyconic": {n:"Polyconic", arg:null, scale:160, ratio:1.3},
+  "quincuncial": {n:"Quincuncial", arg:null, scale:160, ratio:1.3},
+  "rectangularPolyconic": {n:"Rectangular Polyconic", arg:0, scale:160, ratio:1.65},
+  "robinson": {n:"Robinson", arg:null, scale:160},
+  "sinusoidal": {n:"Sinusoidal", arg:null, scale:160, ratio:2},
+  "stereographic": {n:"Stereographic", arg:null, scale:500, ratio:1.0, clip:true},
+  "times": {n:"Times", arg:null, scale:210, ratio:1.4}, 
+  "twoPointEquidistant": {n:"Two-Point Equidistant", arg:Math.PI/2, scale:320, ratio:1.15, clip:true},
+  "vanDerGrinten": {n:"van Der Grinten", arg:null, scale:160, ratio:1.0}, 
+  "vanDerGrinten2": {n:"van Der Grinten II", arg:null, scale:160, ratio:1.0},
+  "vanDerGrinten3": {n:"van Der Grinten III", arg:null, scale:160, ratio:1.0},
+  "vanDerGrinten4": {n:"van Der Grinten IV", arg:null, scale:160, ratio:1.6},
+  "wagner4": {n:"Wagner IV", arg:null, scale:185},
+  "wagner6": {n:"Wagner VI", arg:null, scale:160},
+  "wagner7": {n:"Wagner VII", arg:null, scale:190, ratio:1.8},
+  "wiechel": {n:"Wiechel", arg:null, scale:360, ratio:1.0, clip:true},
+  "winkel3": {n:"Winkel Tripel", arg:null, scale:196, ratio:1.7}
+};
+
+Celestial.projections = function () { return projections; };
+
+var formats = {
+  "starnames": {
+    // "name":"","bayer":"","flam":"","var":"","gl":"","hd":"","c":"","desig":""
+    "iau": {
+      "designation": {
+        "desig": "Designation",     
+        "bayer": "Bayer",
+        "flam": "Flamsteed",
+        "var": "Variable",
+        "gl": "Gliese",
+        "hd": "Draper",
+        "hip": "Hipparcos"},
+      "propername": {
+        "name": "IAU Name",
+        "ar": "Arabic", 
+        "zh": "Chinese",
+        "en": "English",
+        "fi": "Finnish", 
+        "fr": "French", 
+        "de": "German",
+        "el": "Greek", 
+        "he": "Hebrew", 
+        "hi": "Hindi", 
+        "it": "Italian", 
+        "ja": "Japanese", 
+        "ko": "Korean", 
+        "la": "Latin",
+        "fa": "Persian", 
+        "ru": "Russian", 
+        "es": "Spanish",
+        "tr": "Turkish"}
+    },
+    "cn": {
+      "propername": {
+        "name": "Proper name",
+        "en": "English",
+        "pinyin": "Pinyin"},
+      "designation": { 
+        "desig": "IAU Designation"}
+    }
+  },
+  "constellations": {
+    "iau": {
+      "names": {
+        "desig": "Designation",
+        "name": "IAU Name",
+        "ar": "Arabic", 
+        "zh": "Chinese",
+        "cz": "Czech", 
+        "en": "English",
+        "ee": "Estonian", 
+        "fi": "Finnish", 
+        "fr": "French", 
+        "de": "German",
+        "el": "Greek", 
+        "he": "Hebrew",
+        "hi": "Hindi", 
+        "it": "Italian", 
+        "ja": "Japanese", 
+        "sw": "Kiswahili",
+        "ko": "Korean", 
+        "la": "Latin",
+        "fa": "Persian", 
+        "ru": "Russian", 
+        "es": "Spanish",
+        "tr": "Turkish"}
+    },
+    "cn": {
+      "names": {
+        "name": "Proper name",
+        "en": "English",
+        "pinyin": "Pinyin"}
+    }             
+  },
+  "planets": {
+    "iau": {
+      "symbol": {
+        "symbol": "\u263e Symbol",
+        "letter": "\u216c Letter",
+        "disk": "\u25cf Disk"},
+      "names": {
+        "desig": "Designation",
+        "ar": "Arabic",
+        "zh": "Chinese",
+        "en": "English",
+        "fr": "French",
+        "de": "German",
+        "el": "Greek",
+        "he": "Hebrew",
+        "hi": "Hindi",
+        "it": "Italian",
+        "ja": "Japanese",
+        "ko": "Korean", 
+        "la": "Latin",
+        "fa": "Persian", 
+        "ru": "Russian",
+        "es": "Spanish"}
+    },
+    "cn": {
+      "symbol": {
+        "symbol": "\u263e Symbol",
+        "letter": "\u216c Letter",
+        "disk": "\u25cf Disk"},
+      "names": {
+        "desig": "Designation",
+        "name": "Chinese",
+        "pinyin": "Pinyin",
+        "en": "English"}
+    }
+  },
+  "dsonames": {
+    "iau": {
+      "names": {
+        "desig": "Designation",
+        "name": "English",
+        "ar": "Arabic", 
+        "zh": "Chinese",
+        "fi": "Finnish", 
+        "fr": "French", 
+        "de": "German",
+        "el": "Greek", 
+        //"he": "Hebrew",
+        "hi": "Hindi", 
+        "it": "Italian", 
+        "ja": "Japanese", 
+        "ko": "Korean", 
+        "la": "Latin",
+        "fa": "Persian", 
+        "ru": "Russian", 
+        "es": "Spanish",
+        "tr": "Turkish"}
+    },
+    "cn": {
+      "names": {
+        "desig": "Designation",
+        "name": "Chinese",
+        "pinyin": "Pinyin",
+        "en": "English"}
+    }
+  }
+};
+
+var formats_all = {
+  "iau": Object.keys(formats.constellations.iau.names).concat(Object.keys(formats.planets.iau.names)).filter( function(value, index, self) { return self.indexOf(value) === index; } ),
+  "cn":  Object.keys(formats.constellations.cn.names).concat(Object.keys(formats.starnames.cn.propername)).filter( function(value, index, self) { return self.indexOf(value) === index; } )
+};
+
+export { arrayfy, bvcolor, formats, formats_all, globalConfig, projections, settings };

package/src/core.js

@@ -0,0 +1,14 @@
+// The library's central object.
+//
+// It lives in its own module rather than in celestial.js because nearly every
+// module refers to it — several of them already at load time (for example
+// `Celestial.settings = ...`). The module graph is circular
+// (celestial <-> config <-> form <-> svg), and in a cycle what matters is which
+// module is evaluated first. This file imports nothing, so it always runs
+// first, and by the time anyone touches the object it already exists.
+export var Celestial = {
+  // Must match the package version — guarded by test/package.test.mjs.
+  version: '0.8.0',
+  container: null,
+  data: []
+};

package/src/d3.js

@@ -0,0 +1,28 @@
+// Only the D3 functions the library actually uses.
+//
+// Why this shape: the call sites stay in `d3.geoPath()` form, so modularisation
+// did not have to rewrite every line of the code — yet the bundler pulls in
+// exactly what is listed here instead of the whole `d3` package. This is also
+// what removes the need for a global `d3` (upstream #134, "d3 is not defined").
+//
+// The projections' raw functions are deliberately NOT here: projection.js
+// resolves those by name, so it imports the two packages as namespaces.
+export { select, selectAll, pointer } from "d3-selection";
+export { json } from "d3-fetch";
+export {
+  geoPath, geoProjection, geoCircle, geoGraticule,
+  geoDistance, geoInterpolate, geoRotation, geoArea, geoContains
+} from "d3-geo";
+export { interpolateNumber, interpolateLab } from "d3-interpolate";
+export { scaleQuantize } from "d3-scale";
+export { timeFormat, timeParse } from "d3-time-format";
+export {
+  symbol, symbolCircle, symbolCross, symbolDiamond,
+  symbolSquare, symbolStar, symbolTriangle, symbolWye
+} from "d3-shape";
+export { zoom, zoomIdentity } from "d3-zoom";
+export { dispatch } from "d3-dispatch";
+
+// Imported for its side effect: d3-transition is what adds the .transition()
+// method to the selection prototype, which celestial.js's animations use.
+import "d3-transition";