@austencloud/backgrounds 0.1.0

package/dist/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * IUFOParticleRenderer - Renders UFO narrative particle effects
+ *
+ * Handles all particle and effect rendering for UFO behaviors:
+ * sample particles, camera flashes, ground dust, afterimages,
+ * sleep Zs, celebration effects, and communication pulses.
+ */
+import type { UFOConfig, UFORenderState, Particle } from "../domain/ufo-types.js";
+export interface IUFOParticleRenderer {
+    /**
+     * Draw all narrative arc visual effects
+     */
+    drawNarrativeEffects(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig): void;
+    /**
+     * Draw sample particle (golden orb traveling up beam)
+     */
+    drawSampleParticle(ctx: CanvasRenderingContext2D, particle: Particle): void;
+    /**
+     * Draw camera flash effect (brief white burst)
+     */
+    drawCameraFlash(ctx: CanvasRenderingContext2D, ufo: UFORenderState): void;
+    /**
+     * Draw ground investigation particles (dust rising)
+     */
+    drawGroundParticles(ctx: CanvasRenderingContext2D, particles: Particle[]): void;
+    /**
+     * Draw panic afterimages (motion blur effect)
+     */
+    drawAfterimages(ctx: CanvasRenderingContext2D, ufo: UFORenderState, shieldColor: string): void;
+    /**
+     * Draw floating sleep Zs
+     */
+    drawSleepZs(ctx: CanvasRenderingContext2D, zs: Particle[]): void;
+    /**
+     * Draw celebration effects (rainbow lights, sparkles)
+     */
+    drawCelebrationEffects(ctx: CanvasRenderingContext2D, ufo: UFORenderState): void;
+    /**
+     * Draw communication pulses traveling to target star
+     */
+    drawCommunicationPulses(ctx: CanvasRenderingContext2D, ufo: UFORenderState): void;
+}
+//# sourceMappingURL=IUFOParticleRenderer.d.ts.map

package/dist/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFOParticleRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,oBAAoB,CAClB,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,GAChB,IAAI,CAAC;IAER;;OAEG;IACH,kBAAkB,CAChB,GAAG,EAAE,wBAAwB,EAC7B,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAAC;IAER;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,GAClB,IAAI,CAAC;IAER;;OAEG;IACH,mBAAmB,CACjB,GAAG,EAAE,wBAAwB,EAC7B,SAAS,EAAE,QAAQ,EAAE,GACpB,IAAI,CAAC;IAER;;OAEG;IACH,eAAe,CACb,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC;IAER;;OAEG;IACH,WAAW,CACT,GAAG,EAAE,wBAAwB,EAC7B,EAAE,EAAE,QAAQ,EAAE,GACb,IAAI,CAAC;IAER;;OAEG;IACH,sBAAsB,CACpB,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,GAClB,IAAI,CAAC;IAER;;OAEG;IACH,uBAAuB,CACrB,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,GAClB,IAAI,CAAC;CACT"}

package/dist/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.js

@@ -0,0 +1,9 @@
+/**
+ * IUFOParticleRenderer - Renders UFO narrative particle effects
+ *
+ * Handles all particle and effect rendering for UFO behaviors:
+ * sample particles, camera flashes, ground dust, afterimages,
+ * sleep Zs, celebration effects, and communication pulses.
+ */
+export {};
+//# sourceMappingURL=IUFOParticleRenderer.js.map

package/dist/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFOParticleRenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFOParticleRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/backgrounds/night-sky/services/contracts/IUFORenderer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * IUFORenderer - Renders the UFO's visual components
+ *
+ * Handles all drawing operations for the UFO hull, dome, shield, beam, lights, and engine glow.
+ * Pure rendering with no state mutation.
+ */
+import type { AccessibilitySettings } from "../../../../core/domain/types.js";
+import type { UFOConfig, UFORenderState, WobbleOffset, MoodVisuals } from "../domain/ufo-types.js";
+export interface IUFORenderer {
+    /**
+     * Draw the complete UFO with all visual layers
+     */
+    draw(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, a11y: AccessibilitySettings, moodVisuals: MoodVisuals, wobble: WobbleOffset): void;
+    /**
+     * Draw warp flash effect (bright glow during warp in/out)
+     */
+    drawWarpFlash(ctx: CanvasRenderingContext2D, ufo: UFORenderState, drawY: number): void;
+    /**
+     * Draw the tractor beam
+     */
+    drawBeam(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number): void;
+    /**
+     * Draw the shield glow
+     */
+    drawShield(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number, moodVisuals: MoodVisuals): void;
+    /**
+     * Draw the hull (saucer body)
+     */
+    drawHull(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number, a11y: AccessibilitySettings): void;
+    /**
+     * Draw the glass dome
+     */
+    drawDome(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number): void;
+    /**
+     * Draw the rim lights
+     */
+    drawLights(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number): void;
+    /**
+     * Draw the engine glow underneath
+     */
+    drawEngineGlow(ctx: CanvasRenderingContext2D, ufo: UFORenderState, config: UFOConfig, drawY: number): void;
+}
+//# sourceMappingURL=IUFORenderer.d.ts.map

package/dist/backgrounds/night-sky/services/contracts/IUFORenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFORenderer.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFORenderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEnG,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CACF,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,qBAAqB,EAC3B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,YAAY,GACnB,IAAI,CAAC;IAER;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,UAAU,CACR,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,GACvB,IAAI,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAAC;IAER;;OAEG;IACH,QAAQ,CACN,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,UAAU,CACR,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER;;OAEG;IACH,cAAc,CACZ,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;CACT"}

package/dist/backgrounds/night-sky/services/contracts/IUFORenderer.js

@@ -0,0 +1,8 @@
+/**
+ * IUFORenderer - Renders the UFO's visual components
+ *
+ * Handles all drawing operations for the UFO hull, dome, shield, beam, lights, and engine glow.
+ * Pure rendering with no state mutation.
+ */
+export {};
+//# sourceMappingURL=IUFORenderer.js.map

package/dist/backgrounds/night-sky/services/contracts/IUFORenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFORenderer.js","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFORenderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/backgrounds/night-sky/services/contracts/IUFOStarScanner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * IUFOStarScanner - Handles star discovery and memory for UFO scanning behavior
+ *
+ * Manages finding nearby stars for the UFO to scan, tracking which stars
+ * have been scanned recently to avoid repetition, and locating stars
+ * near specific positions.
+ */
+import type { UFO, StarInfo } from "../domain/ufo-types.js";
+import type { Dimensions } from "../../../../core/domain/types.js";
+export interface IUFOStarScanner {
+    /**
+     * Find a bright star near the UFO that hasn't been recently scanned
+     * Returns null if no suitable star is found
+     */
+    findNearbyBrightStar(ufo: UFO, dimensions: Dimensions, starProvider: () => StarInfo[]): StarInfo | null;
+    /**
+     * Find the star closest to a given position
+     * Used for tracking stars that may have drifted due to parallax
+     */
+    findStarNearPosition(targetX: number, targetY: number, starProvider: () => StarInfo[]): StarInfo | null;
+    /**
+     * Remember that a star at this position was scanned
+     * Prevents rescanning the same star repeatedly
+     */
+    rememberScannedStar(ufo: UFO, x: number, y: number): void;
+    /**
+     * Generate a grid key for a star position (for memory lookup)
+     */
+    getStarKey(x: number, y: number): string;
+}
+//# sourceMappingURL=IUFOStarScanner.d.ts.map

package/dist/backgrounds/night-sky/services/contracts/IUFOStarScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFOStarScanner.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFOStarScanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,oBAAoB,CAClB,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,MAAM,QAAQ,EAAE,GAC7B,QAAQ,GAAG,IAAI,CAAC;IAEnB;;;OAGG;IACH,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,QAAQ,EAAE,GAC7B,QAAQ,GAAG,IAAI,CAAC;IAEnB;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1C"}

package/dist/backgrounds/night-sky/services/contracts/IUFOStarScanner.js

@@ -0,0 +1,9 @@
+/**
+ * IUFOStarScanner - Handles star discovery and memory for UFO scanning behavior
+ *
+ * Manages finding nearby stars for the UFO to scan, tracking which stars
+ * have been scanned recently to avoid repetition, and locating stars
+ * near specific positions.
+ */
+export {};
+//# sourceMappingURL=IUFOStarScanner.js.map

package/dist/backgrounds/night-sky/services/contracts/IUFOStarScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUFOStarScanner.js","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/contracts/IUFOStarScanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/backgrounds/night-sky/services/domain/ufo-types.d.ts

@@ -0,0 +1,240 @@
+/**
+ * UFO Domain Types
+ *
+ * Shared types for the UFO system services.
+ * Extracted from UFOSystem.ts to enable service decomposition.
+ */
+import type { QualityLevel } from "../../../../core/domain/types.js";
+/** Visual modifiers for each mood state */
+export interface MoodVisuals {
+    lightSpeed: number;
+    bobDepth: number;
+    shieldBrightness: number;
+}
+/** Wobble animation offset for rendering */
+export interface WobbleOffset {
+    x: number;
+    y: number;
+    rotation: number;
+    scale: number;
+}
+export interface UFOConfig {
+    size: number;
+    colors: {
+        hull: string;
+        hullDark: string;
+        dome: string;
+        domeHighlight: string;
+        shield: string;
+        beam: string;
+        beamGlow: string;
+        lights: string[];
+    };
+    speed: number;
+    bounceMargin: number;
+    turnSpeed?: number;
+    turnVariation?: number;
+    driftChance?: number;
+    driftSpeedMultiplier?: number;
+    interval: number;
+    enterDuration: number;
+    exitDuration: number;
+    minActiveDuration: number;
+    maxActiveDuration: number;
+    pauseChance: number;
+    pauseDuration: {
+        min: number;
+        max: number;
+    };
+    scanStarChance: number;
+    groundScanChance: number;
+    justVibeChance?: number;
+    scanDuration: {
+        min: number;
+        max: number;
+    };
+    beamChargeFrames: number;
+    shieldPulseSpeed: number;
+    lightChaseSpeed: number;
+    hoverBobSpeed: number;
+    hoverBobAmount: number;
+    mood?: {
+        excitedDecay: number;
+        startledDecay: number;
+        playfulDecay: number;
+        boredThreshold: number;
+        tirednessRate: number;
+        tiredThreshold: number;
+        moodVisuals: Record<UFOMood, MoodVisuals>;
+    };
+    enabledOnQuality: QualityLevel[];
+}
+export type UFOState = "entering" | "wandering" | "paused" | "scanning_star" | "scanning_ground" | "tracking_event" | "chasing" | "giving_up" | "collecting_sample" | "photographing" | "investigating_ground" | "panicking" | "surfing" | "communicating" | "napping" | "hiding" | "peeking" | "celebrating" | "following" | "exiting" | "inactive";
+/** UFO emotional state - affects behavior and visuals */
+export type UFOMood = "curious" | "excited" | "bored" | "startled" | "playful" | "tired";
+/** How the UFO appears */
+export type UFOEntranceType = "fade" | "warp" | "zoom" | "descend";
+/** How the UFO leaves */
+export type UFOExitType = "fade" | "warp" | "zoom" | "shootUp";
+/** Wobble animation types for personality */
+export type WobbleType = "none" | "curious_tilt" | "startled_jolt" | "disappointed_shake" | "happy_bounce" | "yawn_stretch";
+/** Narrative phase for multi-step interactions */
+export type NarrativePhase = "none" | "detection" | "approach" | "action" | "resolution" | "transition";
+/** A particle effect (sample, ground dust, etc.) */
+export interface Particle {
+    x: number;
+    y: number;
+    targetX: number;
+    targetY: number;
+    progress: number;
+    color: string;
+    size: number;
+    type: "sample" | "dust" | "sparkle" | "z";
+}
+/** Communication pulse for morse-like patterns */
+export interface CommPulse {
+    duration: number;
+    isOn: boolean;
+}
+/** External star data for beam targeting */
+export interface StarInfo {
+    x: number;
+    y: number;
+    brightness: number;
+}
+/** External event position for tracking */
+export interface EventPosition {
+    x: number;
+    y: number;
+    vx?: number;
+    vy?: number;
+    active: boolean;
+}
+/**
+ * UFO render state - the data needed for rendering
+ * Subset of full UFO state focused on visual properties
+ */
+export interface UFORenderState {
+    x: number;
+    y: number;
+    z: number;
+    size: number;
+    state: UFOState;
+    shieldPhase: number;
+    lightPhase: number;
+    beamPhase: number;
+    hoverPhase: number;
+    opacity: number;
+    scale: number;
+    flashIntensity: number;
+    beamTarget: {
+        x: number;
+        y: number;
+    } | null;
+    beamIntensity: number;
+    cameraFlashTimer: number;
+    sampleParticle: Particle | null;
+    groundParticles: Particle[];
+    afterimagePositions: Array<{
+        x: number;
+        y: number;
+        opacity: number;
+    }>;
+    sleepZs: Particle[];
+    rainbowPhase: number;
+    celebrationBouncePhase: number;
+    commTarget: {
+        x: number;
+        y: number;
+    } | null;
+    commPattern: CommPulse[];
+    commPatternIndex: number;
+    commPulseTimer: number;
+}
+/**
+ * Full UFO state - complete state for the state machine
+ */
+export interface UFO extends UFORenderState {
+    targetZ: number;
+    heading: number;
+    turnRate: number;
+    stateTimer: number;
+    stateDuration: number;
+    activeDuration: number;
+    totalTime: number;
+    entranceType: UFOEntranceType;
+    exitType: UFOExitType;
+    targetY: number;
+    startY: number;
+    decloakPhase: number;
+    isDrifting: boolean;
+    mood: UFOMood;
+    moodTimer: number;
+    tiredness: number;
+    lastInterestTime: number;
+    lastClickTime: number;
+    clickCount: number;
+    clickTarget: {
+        x: number;
+        y: number;
+    } | null;
+    chaseTarget: {
+        x: number;
+        y: number;
+        vx: number;
+        vy: number;
+    } | null;
+    chaseStartTime: number;
+    lastChaseDistance: number;
+    giveUpTimer: number;
+    wobbleType: WobbleType;
+    wobbleTimer: number;
+    wobbleIntensity: number;
+    spinAngle: number;
+    isSneaky: boolean;
+    scannedStars: Set<string>;
+    lookAroundTimer: number;
+    narrativePhase: NarrativePhase;
+    narrativeTimer: number;
+    narrativePhaseDuration: number;
+    collectedSamples: number;
+    photographedStars: Set<string>;
+    photoTarget: {
+        x: number;
+        y: number;
+    } | null;
+    anomalyPosition: {
+        x: number;
+        y: number;
+    } | null;
+    panicDirection: number;
+    panicSpeed: number;
+    surfTarget: {
+        x: number;
+        y: number;
+        vx: number;
+        vy: number;
+    } | null;
+    surfOffset: {
+        x: number;
+        y: number;
+    };
+    awaitingResponse: boolean;
+    napStartY: number;
+    hidePosition: {
+        x: number;
+        y: number;
+    } | null;
+    peekProgress: number;
+    peekDirection: number;
+    celebrationSpinSpeed: number;
+    buddyTarget: {
+        x: number;
+        y: number;
+        vx: number;
+        vy: number;
+    } | null;
+    buddyOffset: number;
+    rareBrowseies: number;
+}
+//# sourceMappingURL=ufo-types.d.ts.map

package/dist/backgrounds/night-sky/services/domain/ufo-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ufo-types.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/domain/ufo-types.ts"],"names":[],"mappings":"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"}

package/dist/backgrounds/night-sky/services/domain/ufo-types.js

@@ -0,0 +1,8 @@
+/**
+ * UFO Domain Types
+ *
+ * Shared types for the UFO system services.
+ * Extracted from UFOSystem.ts to enable service decomposition.
+ */
+export {};
+//# sourceMappingURL=ufo-types.js.map

package/dist/backgrounds/night-sky/services/domain/ufo-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ufo-types.js","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/domain/ufo-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/backgrounds/night-sky/services/implementations/NightSkyCalculationService.d.ts

@@ -0,0 +1,56 @@
+import type { AccessibilitySettings } from "../../../../core/domain/types.js";
+import type { Dimensions } from "../../../../core/domain/types.js";
+import type { StarConfig, Star, MoonIllumination } from "../../domain/models/night-sky-models.js";
+import type { INightSkyCalculationService } from "../contracts/INightSkyCalculationService.js";
+export declare class NightSkyCalculationService implements INightSkyCalculationService {
+    private observerLatitude;
+    /**
+     * Generate a random float between min and max
+     */
+    randFloat(min: number, max: number): number;
+    /**
+     * Generate a random integer between min and max (inclusive)
+     */
+    randInt(min: number, max: number): number;
+    /**
+     * Pick a random item from an array
+     */
+    randItem<T>(arr: readonly T[]): T;
+    /**
+     * Create a star with randomized properties
+     */
+    makeStar(dimensions: Dimensions, config: StarConfig, accessibility: AccessibilitySettings): Star;
+    setObserverLatitude(latitude: number): void;
+    getObserverLatitude(): number;
+    /**
+     * Calculate comprehensive moon illumination data.
+     *
+     * This provides:
+     * - Accurate phase position in the lunar cycle
+     * - Illumination fraction
+     * - Waxing/waning state
+     * - Parallactic angle (orientation based on observer's latitude)
+     * - Earthshine intensity (visible during crescent phases)
+     */
+    getMoonIllumination(date: Date, latitude?: number): MoonIllumination;
+    /**
+     * Calculate parallactic angle - the rotation of the moon based on observer's position.
+     *
+     * This is a simplified calculation that captures the main effect:
+     * - Northern latitudes see the moon oriented one way
+     * - Southern latitudes see it "upside down"
+     * - Near equator, the moon appears tilted
+     */
+    private calculateParallacticAngle;
+    /**
+     * Calculate earthshine intensity.
+     *
+     * Earthshine is the faint glow on the dark side of the moon
+     * caused by sunlight reflected off Earth. It's most visible
+     * during crescent phases when:
+     * 1. The dark portion of the moon is large (low illumination)
+     * 2. Earth is showing its "full" face to the moon (reflecting max light)
+     */
+    private calculateEarthshineIntensity;
+}
+//# sourceMappingURL=NightSkyCalculationService.d.ts.map

package/dist/backgrounds/night-sky/services/implementations/NightSkyCalculationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NightSkyCalculationService.d.ts","sourceRoot":"","sources":["../../../../../src/backgrounds/night-sky/services/implementations/NightSkyCalculationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EACV,UAAU,EACV,IAAI,EACJ,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAU/F,qBAAa,0BAA2B,YAAW,2BAA2B;IAC5E,OAAO,CAAC,gBAAgB,CAAM;IAE9B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;IAOjC;;OAEG;IACH,QAAQ,CACN,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,qBAAqB,GACnC,IAAI;IAgDP,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI3C,mBAAmB,IAAI,MAAM;IAI7B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAkDpE;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA6BjC;;;;;;;;OAQG;IACH,OAAO,CAAC,4BAA4B;CAqBrC"}