@johnmorrisdotca/hoshi-stars 0.0.0-stage → 0.2.0

package/dist/time-scale.js

@@ -0,0 +1,71 @@
+// From UTC (as JavaScript counts it) to Terrestrial Time, the scale the IAU rotation rates of the planets are in. TT runs ahead of UTC by the leap seconds (TAI - UTC) plus 32.184 s.
+// Before 1972, when UTC had no leap seconds, TT - UT is delta T, from the polynomial fits of F. Espenak and J. Meeus (NASA, "Polynomial Expressions for Delta T", 2006), which are formulas, written out here.
+// After the last leap second in the table (2017) the offset stays at 37 s + 32.184 s until a new leap second is announced: add a row below. TDB - TT, under 2 milliseconds, is ignored.
+// Pure: no DOM, no clock. Not an entry point of the package; `horizontalFrom` in `/sky` uses it.
+/** Each leap second's day (UTC, as milliseconds since 1970) and TAI - UTC in seconds from that day on. */
+const LEAPS = [
+    [Date.UTC(1972, 0, 1), 10], [Date.UTC(1972, 6, 1), 11], [Date.UTC(1973, 0, 1), 12], [Date.UTC(1974, 0, 1), 13], [Date.UTC(1975, 0, 1), 14], [Date.UTC(1976, 0, 1), 15],
+    [Date.UTC(1977, 0, 1), 16], [Date.UTC(1978, 0, 1), 17], [Date.UTC(1979, 0, 1), 18], [Date.UTC(1980, 0, 1), 19], [Date.UTC(1981, 6, 1), 20], [Date.UTC(1982, 6, 1), 21],
+    [Date.UTC(1983, 6, 1), 22], [Date.UTC(1985, 6, 1), 23], [Date.UTC(1988, 0, 1), 24], [Date.UTC(1990, 0, 1), 25], [Date.UTC(1991, 0, 1), 26], [Date.UTC(1992, 6, 1), 27],
+    [Date.UTC(1993, 6, 1), 28], [Date.UTC(1994, 6, 1), 29], [Date.UTC(1996, 0, 1), 30], [Date.UTC(1997, 6, 1), 31], [Date.UTC(1999, 0, 1), 32], [Date.UTC(2006, 0, 1), 33],
+    [Date.UTC(2009, 0, 1), 34], [Date.UTC(2012, 6, 1), 35], [Date.UTC(2015, 6, 1), 36], [Date.UTC(2017, 0, 1), 37],
+];
+const TT_MINUS_TAI = 32.184;
+/** The first moment of a year (UTC), for any year: `Date.UTC` reads 0 to 99 as 1900 to 1999. */
+function startOf(year) {
+    const date = new Date(0);
+    date.setUTCFullYear(year, 0, 1);
+    return date.getTime();
+}
+/** Espenak and Meeus's delta T (TT - UT, seconds) for a year with a fraction. */
+function deltaT(y) {
+    const poly = (t, ...c) => c.reduceRight((sum, k) => sum * t + k, 0);
+    if (y < -500)
+        return -20 + 32 * ((y - 1820) / 100) ** 2;
+    if (y < 500)
+        return poly(y / 100, 10583.6, -1014.41, 33.78311, -5.952053, -0.1798452, 0.022174192, 0.0090316521);
+    if (y < 1600)
+        return poly((y - 1000) / 100, 1574.2, -556.01, 71.23472, 0.319781, -0.8503463, -0.005050998, 0.0083572073);
+    if (y < 1700)
+        return poly(y - 1600, 120, -0.9808, -0.01532, 1 / 7129);
+    if (y < 1800)
+        return poly(y - 1700, 8.83, 0.1603, -0.0059285, 0.00013336, -1 / 1_174_000);
+    if (y < 1860)
+        return poly(y - 1800, 13.72, -0.332447, 0.0068612, 0.0041116, -0.00037436, 0.0000121272, -0.0000001699, 0.000000000875);
+    if (y < 1900)
+        return poly(y - 1860, 7.62, 0.5737, -0.251754, 0.01680668, -0.0004473624, 1 / 233_174);
+    if (y < 1920)
+        return poly(y - 1900, -2.79, 1.494119, -0.0598939, 0.0061966, -0.000197);
+    if (y < 1941)
+        return poly(y - 1920, 21.2, 0.84493, -0.0761, 0.0020936);
+    if (y < 1961)
+        return poly(y - 1950, 29.07, 0.407, -1 / 233, 1 / 2547);
+    if (y < 1986)
+        return poly(y - 1975, 45.45, 1.067, -1 / 260, -1 / 718);
+    return poly(y - 2000, 63.86, 0.3345, -0.060374, 0.0017275, 0.000651814, 0.00002373599);
+}
+/**
+ * The offset TT - UTC in seconds at a moment given in UTC: 42.184 s at the start of 1972 and 69.184 s from 2017 on; before 1972, delta T (TT - UT) from the Espenak and Meeus fit.
+ *
+ * @param utcMs - Milliseconds since 1970 (UTC), finite.
+ * @returns Seconds to add to UTC to get Terrestrial Time.
+ *
+ * @example
+ * ```ts
+ * import { terrestrialMinusUtc } from "./time-scale.ts";
+ *
+ * console.log(terrestrialMinusUtc(Date.UTC(2026, 10, 8)), terrestrialMinusUtc(Date.UTC(2000, 0, 1)));
+ * ```
+ */
+export function terrestrialMinusUtc(utcMs) {
+    if (utcMs >= LEAPS[0][0]) {
+        let tai = LEAPS[0][1];
+        for (const [from, seconds] of LEAPS)
+            if (utcMs >= from)
+                tai = seconds;
+        return tai + TT_MINUS_TAI;
+    }
+    const year = new Date(utcMs).getUTCFullYear();
+    const start = startOf(year);
+    return deltaT(year + (utcMs - start) / (startOf(year + 1) - start));
+}

package/dist/when.d.ts

@@ -0,0 +1,16 @@
+/** The J2000.0 epoch (2000 January 1, 12:00 UTC, which is TT to within the 64 seconds this package ignores) in milliseconds since 1970. */
+export declare const J2000_MS = 946728000000;
+/**
+ * A moment: a `Date` or a number of milliseconds since 1970 (UTC, as JavaScript counts).
+ *
+ * @example
+ * ```ts
+ * import { starPosition, starByName, type When } from "@johnmorrisdotca/hoshi-stars";
+ *
+ * const when: When = new Date(Date.UTC(2026, 10, 7));
+ * console.log(starPosition(starByName("Sirius")!, when).declination.toFixed(4));
+ * ```
+ */
+export type When = Date | number;
+/** A moment as milliseconds since 1970. A `Date` is never changed. An invalid `Date`, a number that is not finite or anything else throws, naming the argument and the value. */
+export declare function moment(when: When, name?: string): number;

package/dist/when.js

@@ -0,0 +1,18 @@
+// A moment as the star functions take it: a `Date` or milliseconds since 1970 (UTC as JavaScript counts it). Pure: no DOM.
+/** The J2000.0 epoch (2000 January 1, 12:00 UTC, which is TT to within the 64 seconds this package ignores) in milliseconds since 1970. */
+export const J2000_MS = 946_728_000_000;
+/** A moment as milliseconds since 1970. A `Date` is never changed. An invalid `Date`, a number that is not finite or anything else throws, naming the argument and the value. */
+export function moment(when, name = "when") {
+    if (typeof when === "number") {
+        if (Number.isFinite(when))
+            return when;
+    }
+    else if (typeof when?.getTime === "function") {
+        const ms = when.getTime();
+        if (Number.isFinite(ms))
+            return ms;
+    }
+    else
+        throw new TypeError(`${name} must be a Date or a number of milliseconds since 1970, got ${typeof when}`);
+    throw new RangeError(`${name} must be a valid Date or a finite number of milliseconds since 1970, got ${String(when)}`);
+}

package/package.json

@@ -1,6 +1,186 @@
 {
   "name": "@johnmorrisdotca/hoshi-stars",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Hoshi 星: stars you can see without a telescope, as data and as sky charts. 5,080 stars with names, distance and colour, the 88 constellations with lines and boundaries, the Messier objects and seven map projections. Typed, no dependencies.",
+  "keywords": [
+    "stars",
+    "milky-way",
+    "star-catalog",
+    "bright-star-catalogue",
+    "yale",
+    "astronomy",
+    "constellations",
+    "constellation-boundaries",
+    "deep-sky",
+    "messier",
+    "ngc",
+    "proper-motion",
+    "javascript",
+    "typescript",
+    "zero-dependencies",
+    "itsutsu",
+    "spaceprogramx",
+    "spx",
+    "space",
+    "star",
+    "star-chart",
+    "star-map",
+    "starmap",
+    "sky-chart",
+    "sky-map",
+    "night-sky",
+    "sky",
+    "planetarium",
+    "celestial",
+    "celestial-sphere",
+    "astrometry",
+    "cartography",
+    "visualization",
+    "map-projection",
+    "stereographic",
+    "svg",
+    "constellation",
+    "star-names",
+    "galaxies",
+    "nebulae",
+    "star-clusters",
+    "observer",
+    "altitude",
+    "azimuth",
+    "horizon",
+    "sidereal-time",
+    "precession",
+    "japanese",
+    "katakana"
+  ],
+  "homepage": "https://johnmorrisdotca.github.io/hoshi-stars/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnmorrisdotca/hoshi-stars.git"
+  },
+  "bugs": {
+    "url": "https://github.com/johnmorrisdotca/hoshi-stars/issues"
+  },
+  "author": "John Morris",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./constellations": {
+      "types": "./dist/constellations.d.ts",
+      "import": "./dist/constellations.js",
+      "default": "./dist/constellations.js"
+    },
+    "./lines": {
+      "types": "./dist/lines.d.ts",
+      "import": "./dist/lines.js",
+      "default": "./dist/lines.js"
+    },
+    "./boundaries": {
+      "types": "./dist/boundaries.d.ts",
+      "import": "./dist/boundaries.js",
+      "default": "./dist/boundaries.js"
+    },
+    "./deep-sky": {
+      "types": "./dist/deep-sky.d.ts",
+      "import": "./dist/deep-sky.js",
+      "default": "./dist/deep-sky.js"
+    },
+    "./deep-sky/ngc-ic": {
+      "types": "./dist/deep-sky-ngc-ic.d.ts",
+      "import": "./dist/deep-sky-ngc-ic.js",
+      "default": "./dist/deep-sky-ngc-ic.js"
+    },
+    "./projection": {
+      "types": "./dist/projection.d.ts",
+      "import": "./dist/projection.js",
+      "default": "./dist/projection.js"
+    },
+    "./milky-way": {
+      "types": "./dist/milky-way.d.ts",
+      "import": "./dist/milky-way.js",
+      "default": "./dist/milky-way.js"
+    },
+    "./sky": {
+      "types": "./dist/sky.d.ts",
+      "import": "./dist/sky.js",
+      "default": "./dist/sky.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE.md",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.11.0",
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.check.json && tsc -p tsconfig.tools.json && tsc -p tsconfig.demo.json",
+    "test": "node --test test/*.test.ts",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build && node scripts/check-package.ts",
+    "test:package": "pnpm build && node scripts/check-package.ts",
+    "prepublishOnly": "pnpm check",
+    "site": "pnpm build && node scripts/site.ts",
+    "dev": "pnpm site && node scripts/dev.ts",
+    "test:demo": "pnpm site && node scripts/docs-site.mjs build && playwright test",
+    "family:readme": "node scripts/family-readme.mjs",
+    "test:demo:one": "pnpm site && node scripts/docs-site.mjs build && playwright test",
+    "test:usage": "pnpm site && node scripts/check-usage.ts",
+    "docs:site": "pnpm build && node scripts/docs-site.mjs build",
+    "docs:check": "pnpm build && node scripts/docs-site.mjs check",
+    "size": "node scripts/docs-site.mjs size",
+    "check:standard": "node scripts/check-standard.mjs"
+  },
+  "devDependencies": {
+    "@angular/common": "^22.2.5",
+    "@angular/compiler": "^22.2.5",
+    "@angular/core": "^22.2.5",
+    "@angular/platform-browser": "^22.2.5",
+    "@eslint/js": "^9.0.0",
+    "@johnmorrisdotca/kazoku-ui": "^0.20.0",
+    "@johnmorrisdotca/wakusei-planets": "^0.20.0",
+    "@playwright/test": "1.64.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-vue": "^6.0.10",
+    "esbuild": "^0.25.0",
+    "eslint": "^9.0.0",
+    "marked": "^18.1.3",
+    "pagefind": "^1.6.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "rxjs": "^7.8.2",
+    "svelte": "^5.57.3",
+    "typescript": "^5.9.0",
+    "typescript-eslint": "^8.0.0",
+    "vite": "^8.3.6",
+    "vue": "^3.5.45",
+    "webpack": "^5.112.2",
+    "webpack-cli": "^7.3.1"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}