siderust-js 0.1.0

package/tempoch-js/README.md

@@ -0,0 +1,126 @@
+# tempoch-js workspace
+
+JavaScript and WebAssembly bindings for
+[tempoch](./tempoch/README.md), the Siderust astronomical time library.
+
+This repository is the publishable JS workspace. It contains the npm packages,
+the thin Rust transport layers for Node and Web, and the vendored `tempoch`
+workspace that provides the canonical time-scale, epoch, and period logic.
+
+## Packages
+
+| Package | Target | Status | Notes |
+| --- | --- | --- | --- |
+| [`@siderust/tempoch`](./tempoch-node/README.md) | Node.js | `0.1.0` | Native addon built with `napi-rs`; uses `@siderust/qtty@^0.1.0` for quantity objects in the JS API. |
+| `@siderust/tempoch-web` | Browsers / bundlers | `0.1.0` | WebAssembly build with `wasm-bindgen`; requires `await init()` and uses `@siderust/qtty-web@^0.1.0` for quantity objects in the API. |
+
+The Rust crates under `tempoch-node/` and `tempoch-web/` are transport layers
+only. All astronomical time semantics come from the vendored
+[`tempoch`](./tempoch) workspace.
+
+## Repository layout
+
+```text
+tempoch-js/
+├── tempoch/       Vendored Rust workspace (canonical time logic)
+├── tempoch-node/  Node package: @siderust/tempoch
+├── tempoch-web/   Browser package: @siderust/tempoch-web
+└── scripts/       CI helpers for the Node package
+```
+
+## What ships in 0.1.0
+
+- A Node package exposing `JulianDate`, `ModifiedJulianDate`, `Period`, UTC
+  conversion helpers, and epoch arithmetic utilities.
+- A browser/WASM package exposing the same core time model with explicit async
+  initialization via `init()`.
+- JS APIs that interoperate with the published `qtty-js` `0.1.0` line, using
+  `@siderust/qtty` and `@siderust/qtty-web` quantity objects for durations and
+  day-count results.
+- TypeScript declarations for both packages matching the runtime surface.
+- Node examples, tests, and CI for format, lint, build, test, and coverage.
+
+## Install
+
+### Node.js
+
+```bash
+npm install @siderust/tempoch @siderust/qtty
+```
+
+```js
+const { JulianDate } = require('@siderust/tempoch');
+const { Hours } = require('@siderust/qtty/units');
+
+const jd = JulianDate.j2000();
+const later = jd.add(Hours(6));
+console.log(later.toDate().toISOString());
+```
+
+### Browser / WebAssembly
+
+```bash
+npm install @siderust/tempoch-web @siderust/qtty-web
+```
+
+```js
+import { init, JulianDate } from '@siderust/tempoch-web';
+import { Quantity } from '@siderust/qtty-web';
+
+await init();
+
+const jd = JulianDate.j2000();
+const later = jd.add(new Quantity(6, 'Hour'));
+console.log(later.toDate().toISOString());
+```
+
+## Development
+
+Clone the repository with submodules so the vendored Rust workspace is present:
+
+```bash
+git clone --recurse-submodules git@github.com:Siderust/tempoch-js.git
+cd tempoch-js
+```
+
+If you already cloned without submodules:
+
+```bash
+git submodule update --init --recursive
+```
+
+### Node package workflow
+
+```bash
+cd tempoch-node
+npm ci
+npm run build:debug
+npm test
+```
+
+The repository also exposes CI helpers:
+
+```bash
+./scripts/ci.sh all
+```
+
+### Web package workflow
+
+`tempoch-web` uses `wasm-pack`:
+
+```bash
+cd tempoch-web
+wasm-pack build --target web --out-dir pkg --release --scope siderust
+```
+
+## Related documentation
+
+- [`tempoch-node/README.md`](./tempoch-node/README.md) for the Node package API
+  and examples.
+- [`tempoch/README.md`](./tempoch/README.md) for the vendored Rust workspace.
+- [`tempoch/CHANGELOG.md`](./tempoch/CHANGELOG.md) for backend/library changes
+  that feed these bindings.
+
+## License
+
+AGPL-3.0. See [LICENSE](./LICENSE).

package/tempoch-js/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "tempoch-js",
+  "version": "0.1.0",
+  "description": " high-precision, type-safe time computations. Provides strongly-typed time units, durations, and arithmetic with compile-time guarantees, enabling robust temporal calculations for scientific and systems software. ",
+  "homepage": "https://github.com/Siderust/tempoch-js#readme",
+  "bugs": {
+    "url": "https://github.com/Siderust/tempoch-js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Siderust/tempoch-js.git"
+  },
+  "license": "AGPL-3.0-or-later",
+  "author": "VPRamon",
+  "type": "commonjs",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/tempoch-js/scripts/ci.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PACKAGE_DIR="$ROOT_DIR/tempoch-node"
+STEP="${1:-all}"
+
+run_install() {
+  cd "$PACKAGE_DIR"
+  npm ci
+}
+
+run_format() {
+  cd "$PACKAGE_DIR"
+  npm run format:check
+}
+
+run_lint() {
+  cd "$PACKAGE_DIR"
+  npm run lint
+}
+
+run_build() {
+  cd "$PACKAGE_DIR"
+  if [[ "${BUILD_MODE:-debug}" == "release" ]]; then
+    npm run build
+  else
+    npm run build:debug
+  fi
+}
+
+run_test() {
+  cd "$PACKAGE_DIR"
+  npm test
+}
+
+run_coverage() {
+  cd "$PACKAGE_DIR"
+  npm run test:coverage
+}
+
+case "$STEP" in
+  install)
+    run_install
+    ;;
+  format)
+    run_format
+    ;;
+  lint)
+    run_lint
+    ;;
+  build)
+    run_build
+    ;;
+  test)
+    run_test
+    ;;
+  coverage)
+    run_coverage
+    ;;
+  all)
+    run_install
+    run_format
+    run_lint
+    run_build
+    run_test
+    run_coverage
+    ;;
+  *)
+    echo "Usage: $0 [install|format|lint|build|test|coverage|all]" >&2
+    exit 1
+    ;;
+esac

package/tempoch-js/tempoch/.github/workflows/ci.yml

@@ -0,0 +1,113 @@
+name: tempoch 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:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo check --all-targets
+
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - run: cargo clippy --all-targets -- -D warnings
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo test --all-targets
+      - run: cargo test --doc
+
+  coverage:
+    name: Test & Coverage
+    if: ${{ github.event_name == 'push' || github.event.pull_request.draft == false }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Rust (nightly + llvm-tools)
+        uses: dtolnay/rust-toolchain@v1
+        with:
+          toolchain: nightly
+          components: llvm-tools-preview
+
+      - name: Install cargo-llvm-cov
+        uses: taiki-e/install-action@v2
+        with:
+          tool: cargo-llvm-cov
+
+      - name: Coverage (run, no report)
+        run: cargo +nightly llvm-cov --workspace --all-features --doctests --no-report
+
+      - name: Coverage (Cobertura XML)
+        run: cargo +nightly llvm-cov report --cobertura --output-path coverage.xml
+
+      - name: Coverage (HTML)
+        run: cargo +nightly llvm-cov report --html --output-dir coverage_html
+
+      - name: Build coverage summary (Markdown)
+        uses: irongut/CodeCoverageSummary@v1.3.0
+        with:
+          filename: coverage.xml
+          badge: true
+          format: markdown
+          output: file
+
+      - name: Publish to Job Summary
+        run: cat code-coverage-results.md >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Post coverage as PR comment
+        if: github.event_name == 'pull_request'
+        uses: mshick/add-pr-comment@v2
+        with:
+          message-path: code-coverage-results.md
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Coverage gate (>=90% lines)
+        run: cargo +nightly llvm-cov --workspace --all-features --doctests --no-run --fail-under-lines 90
+
+      - name: Upload coverage HTML
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: coverage_html
+          retention-days: 7

package/tempoch-js/tempoch/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Time scale conversion functions in FFI (`tempoch_jd_to_tt`, `tempoch_tt_to_jd`, `tempoch_jd_to_mjd`, `tempoch_mjd_to_jd`, `tempoch_jd_to_tai`, `tempoch_tai_to_jd`, `tempoch_jd_to_tdb`, `tempoch_tdb_to_jd`, `tempoch_jd_to_tcg`, `tempoch_tcg_to_jd`, `tempoch_jd_to_tcb`, `tempoch_tcb_to_jd`, `tempoch_jd_to_gps`, `tempoch_gps_to_jd`, `tempoch_jd_to_jde`, `tempoch_jde_to_jd`, `tempoch_jd_to_unix`, `tempoch_unix_to_jd`, `tempoch_jd_add_days`, `tempoch_jd_difference`, `tempoch_jd_difference_qty`, `tempoch_jd_add_qty`).
+- `TempochScale` enum in FFI to enumerate all supported time scales.
+
+### Changed
+
+- Improved formatting and consistency in FFI time conversion implementations.
+
+## [0.3.0 - 2026-02-19]
+
+### Added
+
+- `Time::try_new` and `Time::try_from_days` validated constructors that reject `NaN`/`±∞`.
+- `Interval::try_new` validated constructor that rejects `start > end` (and `NaN` endpoints).
+- `NonFiniteTimeError`, `InvalidIntervalError`, `PeriodListError` error types.
+- `validate_period_list` — checks sorted/non-overlapping invariants on a period slice.
+- `normalize_periods` — sorts and merges overlapping intervals into a valid list.
+- FFI: generated C header is now also written to `tempoch-ffi/include/tempoch_ffi.h`.
+
+### Changed
+
+- `Time::new` and `Interval::new` now carry documentation warnings about
+  accepting unchecked input; prefer the new `try_*` constructors for
+  untrusted data.
+- Serde deserialization of `Time<S>`, `Period<MJD>`, and `Period<JD>` now
+  rejects non-finite values and invalid intervals (start > end).
+- `Time::<JD>::tt_to_tdb` now delegates to the shared `tdb_minus_tt_days`
+  function (previously duplicated the Fairhead & Bretagnon math).
+
+### Fixed
+
+- Eliminated duplicated TDB correction logic between `scales.rs` and
+  `julian_date_ext.rs`, reducing drift risk.
+
+## [0.2.1 - 2026-02-19]
+
+### Added
+
+- FFI support
+
+### Fixed
+
+- Preserve sub-second precision in `Interval<DateTime<Utc>>::duration_days()` by computing from nanoseconds instead of truncating via whole seconds.
+
+## [0.2.0 - 2026-02-16]
+
+### Added
+
+- New coordinate time scales: `TCG` (Geocentric Coordinate Time) and `TCB` (Barycentric Coordinate Time).
+- Crate-root exports for `TCG` and `TCB` (`tempoch::TCG`, `tempoch::TCB`).
+- Additional conversion tests covering `TDB`, `TCG`, `TCB`, and leap-second-aware Unix conversions.
+
+### Changed
+
+- `TDB` conversions no longer treat `TT` as strictly identical; they now apply periodic Fairhead & Bretagnon correction terms.
+- `UnixTime` conversions now apply leap-second-aware UTC/TAI/TT offsets from an IERS Bulletin C table (1972–2017).
+- `ΔT` now uses observed annual values for 1992–2025 and linear near-term extrapolation after 2026, replacing the prior modern-year approximation.
+
+## [0.1.0 - 2026-02-12]
+
+### Added
+
+- Initial standalone release extracted from `siderust::time`.
+- Generic time instants and scales via `Time<S>` and `TimeScale`.
+- Marker scales: `JD`, `JDE`, `MJD`, `TDB`, `TT`, `TAI`, `GPS`, `UnixTime`, `UT`.
+- `JulianDate`, `JulianEphemerisDay`, `ModifiedJulianDate`, `UniversalTime` aliases.
+- UTC conversion helpers (`from_utc`, `to_utc`) using `chrono`.
+- Automatic `ΔT` correction layer for `UT` conversions.
+- Generic intervals (`Interval<T>`) and scale-based periods (`Period<S>`).
+- Set-like period utilities: `intersect_periods` and `complement_within`.
+- GitHub Actions CI workflow with check/fmt/clippy/test/doctest/coverage jobs.
+- Runnable examples and integration tests.