v7.1.0

.eslintrc.json

@@ -2,16 +2,30 @@
   "env": {
     "browser": true,
     "es2021": true,
-    "node": true,
-    "jest": true
+    "node": true
   },
-  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "globals": {
+    "describe": "readonly",
+    "it": "readonly",
+    "expect": "readonly",
+    "beforeEach": "readonly",
+    "afterEach": "readonly",
+    "beforeAll": "readonly",
+    "afterAll": "readonly",
+    "vi": "readonly"
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
   "parser": "@typescript-eslint/parser",
   "parserOptions": {
     "ecmaVersion": 12,
     "sourceType": "module"
   },
-  "plugins": ["@typescript-eslint"],
+  "plugins": [
+    "@typescript-eslint"
+  ],
   "rules": {
     "accessor-pairs": "error",
     "array-bracket-newline": "error",
@@ -28,7 +42,10 @@
     "camelcase": "error",
     "capitalized-comments": "off",
     "class-methods-use-this": "off",
-    "comma-dangle": ["error", "always-multiline"],
+    "comma-dangle": [
+      "error",
+      "always-multiline"
+    ],
     "comma-spacing": "error",
     "comma-style": "error",
     "complexity": "error",
@@ -59,25 +76,65 @@
     "id-length": "off",
     "id-match": "error",
     "implicit-arrow-linebreak": "off",
-    "indent": ["error", 2, { "SwitchCase": 1 }],
-    "indent-legacy": ["error", 2, { "SwitchCase": 1 }],
+    "indent": [
+      "error",
+      2,
+      {
+        "SwitchCase": 1
+      }
+    ],
+    "indent-legacy": [
+      "error",
+      2,
+      {
+        "SwitchCase": 1
+      }
+    ],
     "init-declarations": "off",
     "jsx-quotes": "error",
     "key-spacing": "error",
     "keyword-spacing": "error",
     "line-comment-position": "off",
-    "linebreak-style": ["error", "unix"],
+    "linebreak-style": [
+      "error",
+      "unix"
+    ],
     "lines-around-comment": "off",
     "lines-around-directive": "error",
     "lines-between-class-members": "off",
     "max-classes-per-file": "error",
     "max-depth": "error",
-    "max-len": ["error", { "code": 120 }],
-    "max-lines": ["error", { "max": 1000 }],
-    "max-lines-per-function": ["error", { "max": 300 }],
+    "max-len": [
+      "error",
+      {
+        "code": 180
+      }
+    ],
+    "max-lines": [
+      "error",
+      {
+        "max": 1000
+      }
+    ],
+    "max-lines-per-function": [
+      "error",
+      {
+        "max": 300
+      }
+    ],
     "max-nested-callbacks": "error",
-    "max-params": ["error", { "max": 8 }],
-    "max-statements": ["error", { "max": 85 }],
+    "max-params": [
+      "error",
+      {
+        "max": 8
+      }
+    ],
+    "max-statements": [
+      "error",
+      {
+        "max": 85
+      }
+    ],
     "max-statements-per-line": "error",
     "multiline-comment-style": "error",
     "multiline-ternary": "off",
@@ -150,7 +207,21 @@
     "no-restricted-imports": "error",
     "no-restricted-modules": "error",
     "no-restricted-properties": "error",
-    "no-restricted-syntax": "error",
+    "no-restricted-syntax": [
+      "error",
+      {
+        "selector": "ImportDeclaration[source.value=/\\.js$/]",
+        "message": "Do not use .js extension in imports"
+      },
+      {
+        "selector": "ExportNamedDeclaration[source.value=/\\.js$/]",
+        "message": "Do not use .js extension in exports"
+      },
+      {
+        "selector": "ExportAllDeclaration[source.value=/\\.js$/]",
+        "message": "Do not use .js extension in exports"
+      }
+    ],
     "no-return-assign": "error",
     "no-return-await": "error",
     "no-script-url": "error",
@@ -163,9 +234,14 @@
     "no-template-curly-in-string": "error",
     "no-ternary": "off",
     "no-throw-literal": "error",
-    "no-trailing-spaces": ["error", { "ignoreComments": true }],
+    "no-trailing-spaces": [
+      "error",
+      {
+        "ignoreComments": true
+      }
+    ],
     "no-undef-init": "error",
-    "no-undefined": "error",
+    "no-undefined": "off",
     "no-underscore-dangle": "off",
     "no-unmodified-loop-condition": "error",
     "no-unneeded-ternary": "error",
@@ -209,7 +285,10 @@
     "prefer-spread": "error",
     "prefer-template": "error",
     "quote-props": "off",
-    "quotes": ["error", "single"],
+    "quotes": [
+      "error",
+      "single"
+    ],
     "radix": "off",
     "require-atomic-updates": "error",
     "require-await": "error",
@@ -241,4 +320,4 @@
     "yield-star-spacing": "error",
     "yoda": "error"
   }
-}
+}

.github/workflows/ci.yml

@@ -23,20 +23,34 @@ jobs:
 
       - uses: actions/setup-node@v4.0.1
         with:
-          node-version: '20.x'
+          node-version: '24.x'
 
       - run: npm ci --ignore-scripts
 
       - run: npm run lint
-  build:
+  circular-check:
     needs: lint
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4.1.1
 
       - uses: actions/setup-node@v4.0.1
         with:
-          node-version: '20.x'
+          node-version: '24.x'
+
+      - run: npm ci --ignore-scripts
+
+      - name: Check for circular dependencies
+        run: npm run circular
+  build:
+    needs: circular-check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4.1.1
+
+      - uses: actions/setup-node@v4.0.1
+        with:
+          node-version: '24.x'
 
       - uses: actions/cache@v3
         env:
@@ -51,27 +65,58 @@ jobs:
       - run: npm ci --ignore-scripts
 
       - run: npm run build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 1
   test:
     needs: build
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ['24.x']
     steps:
       - uses: actions/checkout@v4.1.1
 
       - uses: actions/setup-node@v4.0.1
         with:
-          node-version: '20.x'
+          node-version: ${{ matrix.node-version }}
 
       - uses: actions/cache@v3
         env:
           cache-name: cache-node-modules
         with:
           path: |
             **/lib
-          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          key: ${{ runner.os }}-node-${{ matrix.node-version }}-${{ hashFiles('**/package-lock.json') }}
           restore-keys: |
-            ${{ runner.os }}-node-
+            ${{ runner.os }}-node-${{ matrix.node-version }}-
 
       - run: npm ci --ignore-scripts
 
       - name: Test
         run: npm run test
+  test-integration:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ['24.x']
+    steps:
+      - uses: actions/checkout@v4.1.1
+
+      - uses: actions/setup-node@v4.0.1
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - run: npm ci --ignore-scripts
+
+      - name: Integration Tests
+        run: npm run test:integration:only

.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: Release
+
+# On every push to main, re-run the CI gate and then hand off to
+# semantic-release. It reads the conventional commits since the last tag,
+# computes the bump (feat -> minor, BREAKING CHANGE -> major, everything else
+# -> patch, per .releaserc.json), updates package.json + CHANGELOG.md, tags,
+# creates the GitHub release, and publishes to npm with provenance.
+#
+# Nothing publishes unless the gate passes. semantic-release itself no-ops when
+# there are no releasable commits, so an empty run is harmless.
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write # tag + push CHANGELOG/package.json, create GitHub release
+  issues: write # semantic-release success/failure comments
+  pull-requests: write
+  id-token: write # npm provenance
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Gate + Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # semantic-release needs full history + tags
+          persist-credentials: false # semantic-release authenticates itself
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci --ignore-scripts
+
+      # --- CI gate (mirrors ci.yml). No publish if any of these fail. ---
+      - name: Lint
+        run: npm run lint
+      - name: Circular dependency check
+        run: npm run circular
+      - name: Build
+        run: npm run build
+      - name: Unit tests
+        run: npm run test
+      - name: Integration tests
+        run: npm run test:integration:only
+
+      # --- Release (no-ops when there are no releasable commits) ---
+      - name: semantic-release
+        run: npx semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_CONFIG_PROVENANCE: 'true'

.gitignore

@@ -4,10 +4,28 @@ coverage
 dist
 node_modules
 *.log
+.npmrc
+
+.claude
+.github/instructions
 
 test/performance
 test/satellite/transform*
 test/sgp4/sgp4prop
 
+FUTURE-WORK.md
+
+circular-deps.svg
+
 **/**.out
 .qodo
+
+src/fetch
+
+CLAUDE.md
+.dev.vars
+
+src/objects/__tests__/propagator-accuracy-summary.txt
+
+docs/.vitepress/cache
+docs/.vitepress/dist

.husky/pre-push

@@ -0,0 +1,7 @@
+# Mirror the CI gate locally so failures surface BEFORE they hit GitHub.
+# Matches the fast jobs in .github/workflows/ci.yml. Bypass with `--no-verify`
+# only when you know what you're doing.
+npm run lint && npm run circular && npm run test
+
+# To also gate the slower build + integration tests before every push, swap the
+# line above for:  npm run lint && npm run circular && npm run test:all

.madgerc

@@ -0,0 +1,15 @@
+{
+  "fileExtensions": [
+    "ts"
+  ],
+  "tsConfig": "./tsconfig.json",
+  "excludeRegExp": [
+    ".*\\.test\\.ts$",
+    ".*__tests__.*"
+  ],
+  "detectiveOptions": {
+    "ts": {
+      "skipTypeImports": true
+    }
+  }
+}