ether-to-astro 1.0.0

package/tests/validation/utils/fixtureTypes.ts

@@ -0,0 +1,146 @@
+import type { PlanetName } from '../../../src/types.js';
+
+export interface NormalizedBody {
+  body: PlanetName | string;
+  longitude: number;
+  latitude?: number;
+  speed?: number;
+  retrograde?: boolean;
+}
+
+export interface NormalizedHouseResult {
+  system: string;
+  cusps: number[];
+  ascendant: number;
+  mc: number;
+}
+
+export interface NormalizedTransit {
+  transitingPlanet: string;
+  natalPlanet: string;
+  aspect: string;
+  orb: number;
+  exactTime?: string;
+  exactTimeStatus?: 'within_preview' | 'outside_preview' | 'not_found' | 'unsupported_body';
+  isApplying: boolean;
+}
+
+export interface NormalizedRoot {
+  jd: number;
+  isoUtc: string;
+}
+
+export interface NormalizedRiseSet {
+  body: string;
+  rise?: string;
+  set?: string;
+  upperMeridianTransit?: string;
+  lowerMeridianTransit?: string;
+}
+
+export interface NormalizedEclipse {
+  type: 'solar' | 'lunar';
+  eclipseType: string;
+  maxTime: string;
+}
+
+export interface PositionFixture {
+  name: string;
+  isoUtc: string;
+  planetIds: number[];
+  expected: NormalizedBody[];
+}
+
+export interface AstrologPositionParityFixture {
+  name: string;
+  isoUtc: string;
+  planetIds: number[];
+}
+
+export interface HouseFixture {
+  name: string;
+  isoUtc: string;
+  latitude: number;
+  longitude: number;
+  houseSystem: string;
+  expected: NormalizedHouseResult;
+}
+
+export interface AstrologHouseParityFixture {
+  name: string;
+  isoUtc: string;
+  latitude: number;
+  longitude: number;
+  houseSystem: 'P' | 'W';
+  expectFallbackToWholeSign?: boolean;
+}
+
+export interface RootFixture {
+  name: string;
+  planetId: number;
+  startIsoUtc: string;
+  endIsoUtc: string;
+  targetLongitude?: number;
+  targetFromStartLongitude?: boolean;
+  targetFromSampledMinimum?: {
+    samples: number;
+  };
+  expectedMinRoots?: number;
+  expectedMaxRoots?: number;
+}
+
+export interface TransitFixture {
+  name: string;
+  currentIsoUtc: string;
+  transitingPlanetId: number;
+  natalPlanetId: number;
+  natalOffsetDegrees: number;
+  expectedAspect: 'conjunction' | 'opposition' | 'square' | 'trine' | 'sextile';
+  expectedIsApplying?: boolean;
+  expectExactTimeStatus?:
+    | 'within_preview'
+    | 'outside_preview'
+    | 'not_found'
+    | 'unsupported_body'
+    | 'undefined';
+}
+
+export interface AstrologTransitSnapshotFixture {
+  name: string;
+  currentIsoUtc: string;
+  transitingPlanetId: number;
+  natalPlanetId: number;
+  natalOffsetDegrees: number;
+  expectedAspect: 'conjunction' | 'opposition' | 'square' | 'trine' | 'sextile';
+  maxOrb: number;
+}
+
+export interface RiseSetFixture {
+  name: string;
+  isoUtc: string;
+  latitude: number;
+  longitude: number;
+  planetId: number;
+  expectedNoRiseSet?: boolean;
+}
+
+export interface EclipseFixture {
+  name: string;
+  startIsoUtc: string;
+  type: 'solar' | 'lunar';
+}
+
+export interface AstrologEdgeParityFixture {
+  name: string;
+  isoUtc: string;
+  planetIds: number[];
+  local?: {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+  };
+  timezone?: string;
+  disambiguation?: 'compatible' | 'earlier' | 'later' | 'reject';
+}

package/tests/validation/utils/report.ts

@@ -0,0 +1,60 @@
+export interface ValidationMismatch {
+  fixture: string;
+  subsystem: string;
+  expected: unknown;
+  actual: unknown;
+  delta: number | string | null;
+  tolerance: number | string;
+  message: string;
+  capability?: 'available' | 'unavailable';
+  validation?: 'executed' | 'skipped_intentionally';
+  details?: unknown;
+}
+
+export class ValidationReport {
+  readonly hardFailures: ValidationMismatch[] = [];
+  readonly warnings: ValidationMismatch[] = [];
+  generatedAt?: string;
+
+  addHard(mismatch: ValidationMismatch): void {
+    this.hardFailures.push(mismatch);
+  }
+
+  addWarning(mismatch: ValidationMismatch): void {
+    this.warnings.push(mismatch);
+  }
+
+  flushWarningsToConsole(): void {
+    for (const w of this.warnings) {
+      // Keep warnings readable but compact.
+      console.warn(
+        `[validation warning] fixture=${w.fixture} subsystem=${w.subsystem} message=${w.message} expected=${JSON.stringify(w.expected)} actual=${JSON.stringify(w.actual)} delta=${w.delta} tolerance=${w.tolerance}`
+      );
+    }
+  }
+
+  toJson(): string {
+    const wallClockIso = new Date(Date.now()).toISOString();
+    return JSON.stringify(
+      {
+        hardFailures: this.hardFailures,
+        warnings: this.warnings,
+        generatedAt: this.generatedAt ?? wallClockIso,
+      },
+      null,
+      2
+    );
+  }
+}
+
+export function formatMismatch(mismatch: ValidationMismatch): string {
+  return [
+    `fixture=${mismatch.fixture}`,
+    `subsystem=${mismatch.subsystem}`,
+    `message=${mismatch.message}`,
+    `expected=${JSON.stringify(mismatch.expected)}`,
+    `actual=${JSON.stringify(mismatch.actual)}`,
+    `delta=${mismatch.delta}`,
+    `tolerance=${mismatch.tolerance}`,
+  ].join(' | ');
+}

package/tests/validation/utils/tolerances.ts

@@ -0,0 +1,23 @@
+export const TOLERANCES = {
+  astrologPositionLongitudeDeg: 0.02,
+  astrologHouseDeg: 0.2,
+  positionLongitudeDeg: 0.0001,
+  positionLatitudeDeg: 0.0001,
+  positionSpeedDegPerDay: 0.0001,
+  houseDeg: 0.01,
+  rootPreferredMinutes: 2,
+  rootHardMinutes: 10,
+  riseSetMinutes: 1,
+  eclipseMinutes: 1,
+  dedupeMinutes: 1,
+};
+
+export const MINUTES_TO_DAYS = 1 / 1440;
+
+export function minutesToDays(minutes: number): number {
+  return minutes * MINUTES_TO_DAYS;
+}
+
+export function minutesBetweenIso(aIso: string, bIso: string): number {
+  return Math.abs(new Date(aIso).getTime() - new Date(bIso).getTime()) / 60000;
+}