siderust-js 0.1.0

package/.github/workflows/ci.yml

@@ -0,0 +1,166 @@
+name: Siderust JS CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+  checks: write
+  pull-requests: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  NODE_VERSION: '20'
+  SIDERUST_DATASETS_DIR: ${{ github.workspace }}/.siderust_datasets
+  SIDERUST_JPL_STUB: all
+
+jobs:
+  format:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: siderust-node/package-lock.json
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            siderust-node -> siderust-node/target
+      - run: ./scripts/ci.sh install
+      - run: ./scripts/ci.sh format
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: siderust-node/package-lock.json
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            siderust-node -> siderust-node/target
+      - run: ./scripts/ci.sh install
+      - run: ./scripts/ci.sh lint
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: siderust-node/package-lock.json
+      - uses: actions/cache@v4
+        with:
+          path: ${{ env.SIDERUST_DATASETS_DIR }}
+          key: siderust-datasets-${{ runner.os }}-v1-${{ hashFiles('siderust/scripts/prefetch_datasets.sh') }}
+          restore-keys: |
+            siderust-datasets-${{ runner.os }}-v1-
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            siderust-node -> siderust-node/target
+      - run: ./scripts/ci.sh install
+      - run: BUILD_MODE=release ./scripts/ci.sh build
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: siderust-node/package-lock.json
+      - uses: actions/cache@v4
+        with:
+          path: ${{ env.SIDERUST_DATASETS_DIR }}
+          key: siderust-datasets-${{ runner.os }}-v1-${{ hashFiles('siderust/scripts/prefetch_datasets.sh') }}
+          restore-keys: |
+            siderust-datasets-${{ runner.os }}-v1-
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            siderust-node -> siderust-node/target
+            qtty-js/qtty-node -> qtty-js/qtty-node/target
+            tempoch-js/tempoch-node -> tempoch-js/tempoch-node/target
+      - run: ./scripts/ci.sh install
+      - run: ./scripts/ci.sh build
+      - run: ./scripts/ci.sh test
+
+  coverage:
+    name: Test & Coverage
+    if: ${{ github.event_name == 'push' || github.event.pull_request.draft == false }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: npm
+          cache-dependency-path: siderust-node/package-lock.json
+      - uses: actions/cache@v4
+        with:
+          path: ${{ env.SIDERUST_DATASETS_DIR }}
+          key: siderust-datasets-${{ runner.os }}-v1-${{ hashFiles('siderust/scripts/prefetch_datasets.sh') }}
+          restore-keys: |
+            siderust-datasets-${{ runner.os }}-v1-
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            siderust-node -> siderust-node/target
+            qtty-js/qtty-node -> qtty-js/qtty-node/target
+            tempoch-js/tempoch-node -> tempoch-js/tempoch-node/target
+      - run: ./scripts/ci.sh install
+      - run: ./scripts/ci.sh build
+      - run: ./scripts/ci.sh coverage
+      - name: Document coverage scope
+        run: |
+          {
+            echo "JavaScript coverage is informational only in this repository."
+            echo
+            echo "The exercised runtime surface is an autogenerated N-API loader; the package logic lives in native Rust."
+          } >> "$GITHUB_STEP_SUMMARY"
+      - name: Upload coverage report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: siderust-js-coverage
+          path: siderust-node/coverage
+          retention-days: 7

package/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "siderust"]
+	path = siderust
+	url = git@github.com:Siderust/siderust.git
+[submodule "qtty-js"]
+	path = qtty-js
+	url = https://github.com/Siderust/qtty-js.git
+[submodule "tempoch-js"]
+	path = tempoch-js
+	url = https://github.com/Siderust/tempoch-js.git

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to the JavaScript workspace are documented here.
+
+## [0.1.0] - 2026-03-11
+
+### Added
+- Initial `siderust-js` workspace release documentation covering the published
+  Node and Web packages.
+- `@siderust/siderust` for Node.js, exposing observer and star models,
+  coordinate transforms, ephemerides, event search helpers, time-period
+  operations, and lunar phase helpers.
+- `@siderust/siderust-web` for browsers and bundlers, exposing the same
+  astronomy surface over WebAssembly with explicit async initialization via
+  `init()`.
+- TypeScript declaration files, examples, package READMEs, and automated tests
+  for the Node and Web packages.
+
+### Changed
+- The public JS API is now strictly typed around the published `qtty-js` and
+  `tempoch-js` packages.
+- Raw numeric time and quantity inputs are no longer part of the public
+  surface; callers must use `Quantity`, `JulianDate`, `ModifiedJulianDate`, and
+  `Period` objects.
+- Public unit-suffixed numeric fields and `*Like` aliases were removed in favor
+  of typed domain objects and unit-neutral field names.