@austencloud/backgrounds 0.1.0

package/dist/backgrounds/night-sky/services/ProceduralNebulaSystem.js

@@ -0,0 +1,220 @@
+const NEBULA_PALETTES = [
+    // Orion-like (pink/magenta)
+    {
+        core: { r: 255, g: 180, b: 220 },
+        mid: { r: 200, g: 100, b: 180 },
+        edge: { r: 120, g: 80, b: 160 },
+    },
+    // Reflection nebula (cool blue)
+    {
+        core: { r: 180, g: 200, b: 255 },
+        mid: { r: 120, g: 150, b: 220 },
+        edge: { r: 80, g: 100, b: 180 },
+    },
+    // Carina-like (warm orange/salmon)
+    {
+        core: { r: 255, g: 200, b: 160 },
+        mid: { r: 220, g: 140, b: 120 },
+        edge: { r: 180, g: 100, b: 120 },
+    },
+];
+export class ProceduralNebulaSystem {
+    clouds = [];
+    dimensions = { width: 0, height: 0 };
+    quality = "high";
+    isEnabled = false;
+    // Offscreen canvas caching for performance
+    offscreenCanvas = null;
+    offscreenCtx = null;
+    needsRedraw = true;
+    lastRedrawTime = 0;
+    REDRAW_INTERVAL = 250; // ms between offscreen redraws
+    // Animation
+    time = 0;
+    // Quality settings - resolution is step size (larger = fewer samples = faster)
+    QUALITY_CONFIG = {
+        high: { cloudCount: 2, resolution: 16, layers: 3 },
+        medium: { cloudCount: 1, resolution: 20, layers: 2 },
+        low: { cloudCount: 1, resolution: 24, layers: 2 },
+        minimal: { cloudCount: 0, resolution: 0, layers: 0 },
+        "ultra-minimal": { cloudCount: 0, resolution: 0, layers: 0 },
+    };
+    noise(x, y, seed) {
+        const s = seed * 0.1;
+        const n1 = Math.sin(x * 1.0 + y * 0.5 + s) * Math.cos(y * 0.8 - x * 0.3 + s);
+        const n2 = Math.sin(x * 2.1 - y * 1.3 + s * 1.3) * Math.cos(y * 1.7 + x * 0.9 + s) * 0.5;
+        const n3 = Math.sin(x * 4.3 + y * 3.7 + s * 0.7) * Math.cos(y * 2.9 - x * 2.1 + s) * 0.25;
+        return (n1 + n2 + n3) / 1.75;
+    }
+    fbm(x, y, seed, octaves) {
+        let value = 0;
+        let amplitude = 1;
+        let frequency = 1;
+        let maxValue = 0;
+        for (let i = 0; i < octaves; i++) {
+            value += amplitude * this.noise(x * frequency, y * frequency, seed + i * 10);
+            maxValue += amplitude;
+            amplitude *= 0.5;
+            frequency *= 2;
+        }
+        return value / maxValue;
+    }
+    initialize(dim, quality) {
+        this.dimensions = dim;
+        this.quality = quality;
+        const config = this.QUALITY_CONFIG[quality];
+        this.isEnabled = config.cloudCount > 0;
+        if (!this.isEnabled) {
+            this.clouds = [];
+            this.offscreenCanvas = null;
+            this.offscreenCtx = null;
+            return;
+        }
+        // Create offscreen canvas
+        this.offscreenCanvas = document.createElement("canvas");
+        this.offscreenCanvas.width = dim.width;
+        this.offscreenCanvas.height = dim.height;
+        this.offscreenCtx = this.offscreenCanvas.getContext("2d");
+        // Generate clouds
+        this.clouds = [];
+        for (let i = 0; i < config.cloudCount; i++) {
+            this.clouds.push(this.generateCloud(i, config.cloudCount));
+        }
+        this.needsRedraw = true;
+        this.lastRedrawTime = 0;
+    }
+    generateCloud(index, total) {
+        const angle = (index / total) * Math.PI * 2 + Math.random() * 0.5;
+        const distance = 0.25 + Math.random() * 0.2;
+        return {
+            centerX: 0.5 + Math.cos(angle) * distance,
+            centerY: 0.5 + Math.sin(angle) * distance,
+            radiusFraction: 0.18 + Math.random() * 0.1,
+            palette: NEBULA_PALETTES[index % NEBULA_PALETTES.length],
+            seedOffset: Math.random() * 1000,
+            phase: Math.random() * Math.PI * 2,
+            rotation: Math.random() * Math.PI * 2,
+        };
+    }
+    update(a11y, frameMultiplier = 1.0) {
+        if (!this.isEnabled)
+            return;
+        const speed = a11y.reducedMotion ? 0.0002 : 0.001;
+        this.time += speed * frameMultiplier;
+        for (const cloud of this.clouds) {
+            cloud.phase += 0.002 * frameMultiplier * (a11y.reducedMotion ? 0.2 : 1);
+        }
+        // Mark for redraw periodically
+        const now = performance.now();
+        if (now - this.lastRedrawTime > this.REDRAW_INTERVAL) {
+            this.needsRedraw = true;
+        }
+    }
+    draw(ctx, a11y) {
+        if (!this.isEnabled || !this.offscreenCanvas || !this.offscreenCtx)
+            return;
+        // Redraw offscreen canvas if needed (throttled for performance)
+        if (this.needsRedraw) {
+            this.renderToOffscreen(a11y);
+            this.needsRedraw = false;
+            this.lastRedrawTime = performance.now();
+        }
+        // Fast: just blit the cached canvas
+        ctx.globalCompositeOperation = "screen";
+        ctx.drawImage(this.offscreenCanvas, 0, 0);
+        ctx.globalCompositeOperation = "source-over";
+    }
+    renderToOffscreen(a11y) {
+        const ctx = this.offscreenCtx;
+        if (!ctx)
+            return;
+        const config = this.QUALITY_CONFIG[this.quality];
+        const { width, height } = this.dimensions;
+        const diagonal = Math.sqrt(width * width + height * height);
+        ctx.clearRect(0, 0, width, height);
+        for (const cloud of this.clouds) {
+            this.renderCloud(ctx, cloud, diagonal, config, a11y);
+        }
+    }
+    renderCloud(ctx, cloud, diagonal, config, a11y) {
+        const { width, height } = this.dimensions;
+        const centerX = cloud.centerX * width;
+        const centerY = cloud.centerY * height;
+        const radius = cloud.radiusFraction * diagonal;
+        const step = config.resolution;
+        const pulse = 0.85 + 0.15 * Math.sin(cloud.phase);
+        const baseAlpha = (a11y.reducedMotion ? 0.05 : 0.08) * pulse;
+        const startX = Math.max(0, centerX - radius);
+        const endX = Math.min(width, centerX + radius);
+        const startY = Math.max(0, centerY - radius);
+        const endY = Math.min(height, centerY + radius);
+        for (let y = startY; y < endY; y += step) {
+            for (let x = startX; x < endX; x += step) {
+                const dx = (x - centerX) / radius;
+                const dy = (y - centerY) / radius;
+                const dist = Math.sqrt(dx * dx + dy * dy);
+                if (dist > 1.1)
+                    continue;
+                const rotX = dx * Math.cos(cloud.rotation) - dy * Math.sin(cloud.rotation);
+                const rotY = dx * Math.sin(cloud.rotation) + dy * Math.cos(cloud.rotation);
+                const noiseX = rotX * 2.5 + this.time;
+                const noiseY = rotY * 2.5;
+                const density = this.fbm(noiseX, noiseY, cloud.seedOffset, config.layers);
+                const falloff = 1 - Math.pow(dist, 1.2);
+                const cloudDensity = Math.max(0, (density * 0.5 + 0.5) * falloff);
+                if (cloudDensity < 0.15)
+                    continue;
+                const color = this.getColor(cloud.palette, dist);
+                const alpha = cloudDensity * baseAlpha;
+                // Draw larger, softer blobs (fewer but bigger)
+                const blobRadius = step * 1.5;
+                const gradient = ctx.createRadialGradient(x, y, 0, x, y, blobRadius);
+                gradient.addColorStop(0, `rgba(${color.r}, ${color.g}, ${color.b}, ${alpha})`);
+                gradient.addColorStop(0.5, `rgba(${color.r}, ${color.g}, ${color.b}, ${alpha * 0.4})`);
+                gradient.addColorStop(1, "transparent");
+                ctx.fillStyle = gradient;
+                ctx.beginPath();
+                ctx.arc(x, y, blobRadius, 0, Math.PI * 2);
+                ctx.fill();
+            }
+        }
+    }
+    getColor(palette, distance) {
+        const t = Math.min(1, distance);
+        if (t < 0.4) {
+            const localT = t / 0.4;
+            return {
+                r: palette.core.r + (palette.mid.r - palette.core.r) * localT,
+                g: palette.core.g + (palette.mid.g - palette.core.g) * localT,
+                b: palette.core.b + (palette.mid.b - palette.core.b) * localT,
+            };
+        }
+        else {
+            const localT = (t - 0.4) / 0.6;
+            return {
+                r: palette.mid.r + (palette.edge.r - palette.mid.r) * localT,
+                g: palette.mid.g + (palette.edge.g - palette.mid.g) * localT,
+                b: palette.mid.b + (palette.edge.b - palette.mid.b) * localT,
+            };
+        }
+    }
+    handleResize(dim) {
+        if (!this.isEnabled)
+            return;
+        this.dimensions = dim;
+        // Recreate offscreen canvas at new size
+        if (this.offscreenCanvas) {
+            this.offscreenCanvas.width = dim.width;
+            this.offscreenCanvas.height = dim.height;
+            this.offscreenCtx = this.offscreenCanvas.getContext("2d");
+        }
+        this.needsRedraw = true;
+    }
+    cleanup() {
+        this.clouds = [];
+        this.offscreenCanvas = null;
+        this.offscreenCtx = null;
+        this.time = 0;
+    }
+}
+//# sourceMappingURL=ProceduralNebulaSystem.js.map

package/dist/backgrounds/night-sky/services/ProceduralNebulaSystem.js.map

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

package/dist/backgrounds/night-sky/services/SpaceshipSystem.d.ts

@@ -0,0 +1,18 @@
+import type { AccessibilitySettings, Dimensions, QualityLevel } from "../../../core/domain/types.js";
+import type { INightSkyCalculationService } from "./contracts/INightSkyCalculationService.js";
+export interface SpaceshipConfig {
+    size: number;
+    speedPercent: number;
+    color: string;
+    enabledOnQuality: QualityLevel[];
+}
+export declare class SpaceshipSystem {
+    private spaceshipState;
+    private config;
+    private calculationService;
+    constructor(config: SpaceshipConfig, calculationService: INightSkyCalculationService);
+    update(dim: Dimensions, a11y: AccessibilitySettings, quality: QualityLevel): void;
+    draw(ctx: CanvasRenderingContext2D, a11y: AccessibilitySettings): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=SpaceshipSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceshipSystem.d.ts","sourceRoot":"","sources":["../../../../src/backgrounds/night-sky/services/SpaceshipSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,UAAU,EACV,YAAY,EACb,MAAM,+BAA+B,CAAC;AAKvC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,kBAAkB,CAA8B;gBAGtD,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,2BAA2B;IAWjD,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY;IAqC1E,IAAI,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,qBAAqB;IA2B/D,OAAO;CAOR"}

package/dist/backgrounds/night-sky/services/SpaceshipSystem.js

@@ -0,0 +1,71 @@
+export class SpaceshipSystem {
+    spaceshipState;
+    config;
+    calculationService;
+    constructor(config, calculationService) {
+        this.config = config;
+        this.calculationService = calculationService;
+        this.spaceshipState = {
+            element: null,
+            timer: 0,
+            interval: this.calculationService.randInt(15000, 30000),
+        };
+    }
+    update(dim, a11y, quality) {
+        if (!this.config.enabledOnQuality.includes(quality)) {
+            this.spaceshipState.element = null;
+            return;
+        }
+        const effectiveSpeed = a11y.reducedMotion ? 0.2 : 1;
+        if (!this.spaceshipState.element) {
+            this.spaceshipState.timer++;
+            if (this.spaceshipState.timer >= this.spaceshipState.interval) {
+                const dir = Math.random() > 0.5 ? 1 : -1;
+                this.spaceshipState.element = {
+                    x: dir > 0 ? -this.config.size : dim.width + this.config.size,
+                    y: Math.random() * dim.height * 0.4 + dim.height * 0.1, // Upper part of sky
+                    width: this.config.size,
+                    height: this.config.size / 2,
+                    speed: this.config.speedPercent * dim.width * effectiveSpeed,
+                    active: true,
+                    direction: dir,
+                    opacity: 1.0,
+                };
+                this.spaceshipState.timer = 0;
+                this.spaceshipState.interval = this.calculationService.randInt(15000, 30000);
+            }
+        }
+        else {
+            const s = this.spaceshipState.element;
+            s.x += s.direction * s.speed;
+            if (s.x < -s.width || s.x > dim.width + s.width) {
+                this.spaceshipState.element = null;
+            }
+        }
+    }
+    draw(ctx, a11y) {
+        const s = this.spaceshipState.element;
+        if (!s)
+            return;
+        ctx.globalAlpha = s.opacity * (a11y.reducedMotion ? 0.7 : 1);
+        ctx.fillStyle = a11y.highContrast ? "#FFFFFF" : this.config.color;
+        // Simple spaceship shape
+        ctx.beginPath();
+        ctx.ellipse(s.x, s.y, s.width / 2, s.height / 2, 0, 0, 2 * Math.PI);
+        ctx.fill();
+        // Add navigation lights
+        ctx.fillStyle = s.direction > 0 ? "#FF0000" : "#00FF00"; // Red/green navigation lights
+        ctx.beginPath();
+        ctx.arc(s.x + s.direction * s.width * 0.3, s.y, Math.max(1, s.width * 0.1), 0, 2 * Math.PI);
+        ctx.fill();
+        ctx.globalAlpha = 1;
+    }
+    cleanup() {
+        this.spaceshipState = {
+            element: null,
+            timer: 0,
+            interval: this.calculationService.randInt(15000, 30000),
+        };
+    }
+}
+//# sourceMappingURL=SpaceshipSystem.js.map

package/dist/backgrounds/night-sky/services/SpaceshipSystem.js.map

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

package/dist/backgrounds/night-sky/services/UFOSystem.d.ts

@@ -0,0 +1,229 @@
+/**
+ * UFOSystem - Intelligent Wandering UFO Easter Egg
+ *
+ * A rare visitor that browses the night sky with curiosity and purpose.
+ * Features:
+ * - Wandering behavior with pauses and direction changes
+ * - Intelligent tractor beam that scans stars, tracks celestial events, or observes ground
+ * - State machine controlling behavior transitions
+ *
+ * Rendering and mood management delegated to:
+ * - IUFORenderer - hull, dome, shield, beam, lights
+ * - IUFOParticleRenderer - narrative effects, particles
+ * - IUFOMoodManager - emotional state, wobble animations
+ */
+import type { AccessibilitySettings, Dimensions, QualityLevel } from "../../../core/domain/types.js";
+import type { INightSkyCalculationService } from "./contracts/INightSkyCalculationService.js";
+import type { IUFORenderer } from "./contracts/IUFORenderer.js";
+import type { IUFOParticleRenderer } from "./contracts/IUFOParticleRenderer.js";
+import type { IUFOMoodManager } from "./contracts/IUFOMoodManager.js";
+import type { IUFOStarScanner } from "./contracts/IUFOStarScanner.js";
+import type { IUFOInteractionHandler } from "./contracts/IUFOInteractionHandler.js";
+import type { IUFOBehaviorRunner } from "./contracts/IUFOBehaviorRunner.js";
+import type { IUFOEntranceAnimator } from "./contracts/IUFOEntranceAnimator.js";
+import type { IUFOExitAnimator } from "./contracts/IUFOExitAnimator.js";
+import type { IUFOMovementController } from "./contracts/IUFOMovementController.js";
+import type { IUFODecisionMaker } from "./contracts/IUFODecisionMaker.js";
+import type { UFOConfig, UFOState, UFOMood, UFOEntranceType, UFOExitType, WobbleType, StarInfo, EventPosition } from "./domain/ufo-types.js";
+export type { UFOConfig, UFOMood, UFOEntranceType, UFOExitType, WobbleType } from "./domain/ufo-types.js";
+export declare class UFOSystem {
+    private ufo;
+    private timer;
+    private config;
+    private calculationService;
+    private quality;
+    private dimensions;
+    private renderer;
+    private particleRenderer;
+    private moodManager;
+    private starScanner;
+    private interactionHandler;
+    private behaviorRunner;
+    private entranceAnimator;
+    private exitAnimator;
+    private movementController;
+    private decisionMaker;
+    private ufoFactory;
+    private stateCallbacks;
+    private behaviorCallbacks;
+    private starProvider;
+    private eventProvider;
+    constructor(config: UFOConfig, calculationService: INightSkyCalculationService, renderer: IUFORenderer, particleRenderer: IUFOParticleRenderer, moodManager: IUFOMoodManager, starScanner: IUFOStarScanner, interactionHandler: IUFOInteractionHandler, behaviorRunner: IUFOBehaviorRunner, entranceAnimator: IUFOEntranceAnimator, exitAnimator: IUFOExitAnimator, movementController: IUFOMovementController, decisionMaker: IUFODecisionMaker);
+    /**
+     * Set provider for nearby stars (for beam targeting)
+     */
+    setStarProvider(provider: () => StarInfo[]): void;
+    /**
+     * Set provider for active celestial events (meteor/comet position)
+     */
+    setEventProvider(provider: () => EventPosition | null): void;
+    /**
+     * Create behavior context for behavior runner
+     */
+    private createBehaviorContext;
+    update(dim: Dimensions, a11y: AccessibilitySettings, quality: QualityLevel): void;
+    /** All entrance types for random selection */
+    private readonly entranceTypes;
+    /** All exit types for random selection */
+    private readonly exitTypes;
+    private spawnUFO;
+    private updateUFO;
+    /**
+     * Trigger a wobble animation (public for testing via UFO Lab)
+     */
+    triggerWobble(type: WobbleType): void;
+    private updateEntering;
+    private updateWandering;
+    /** Calculate shortest angle difference - delegated to movement controller */
+    private angleDiff;
+    private updatePaused;
+    private updateScanning;
+    private updateExiting;
+    private startPause;
+    private decideAfterPause;
+    private startTrackingEvent;
+    private startChasing;
+    private updateChasing;
+    private startGivingUp;
+    private updateGivingUp;
+    private endScanning;
+    /**
+     * UFO arrived at the location user clicked - scan it!
+     */
+    private arriveAtClickTarget;
+    private resumeWandering;
+    private startExiting;
+    private findNearbyBrightStar;
+    private rememberScannedStar;
+    private findStarNearPosition;
+    draw(ctx: CanvasRenderingContext2D, a11y: AccessibilitySettings): void;
+    /**
+     * Manually trigger UFO to appear
+     * @param dim - Screen dimensions
+     * @param entranceType - Optional specific entrance animation
+     * @param exitType - Optional specific exit animation (saved for when UFO leaves)
+     */
+    trigger(dim: Dimensions, entranceType?: UFOEntranceType, exitType?: UFOExitType): void;
+    /**
+     * Trigger UFO with a specific entrance type
+     */
+    triggerWithEntrance(dim: Dimensions, entranceType: UFOEntranceType): void;
+    /**
+     * Check if UFO is currently visible
+     */
+    isActive(): boolean;
+    /**
+     * Get UFO position for external systems
+     */
+    getPosition(): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Get current UFO state for UI display
+     */
+    getState(): UFOState | null;
+    /**
+     * Get current UFO mood for external systems
+     */
+    getMood(): UFOMood | null;
+    /**
+     * Set UFO mood externally (for click interactions, events, etc.)
+     */
+    setMood(mood: UFOMood): void;
+    /**
+     * Get UFO tiredness level (0-1)
+     */
+    getTiredness(): number | null;
+    /**
+     * Reset UFO tiredness to 0 (for testing)
+     */
+    resetTiredness(): void;
+    /**
+     * Get count of scanned stars in UFO's memory
+     */
+    getScannedStarsCount(): number;
+    /**
+     * Clear UFO's memory of scanned stars
+     */
+    clearScannedStars(): void;
+    /**
+     * Get UFO heading in radians
+     */
+    getHeading(): number | null;
+    private updateCollectingSample;
+    private startCollectingSample;
+    private updatePhotographing;
+    private startPhotographing;
+    private updateInvestigatingGround;
+    private startInvestigatingGround;
+    private updatePanicking;
+    private startPanicking;
+    private updateSurfing;
+    private startSurfing;
+    private updateCommunicating;
+    private startCommunicating;
+    private updateNapping;
+    private startNapping;
+    private updatePeekaboo;
+    private startHiding;
+    private updateCelebrating;
+    private startCelebrating;
+    private updateFollowing;
+    private startFollowing;
+    /**
+     * Handle a click on the canvas - UFO reacts based on distance and mood
+     * @param clickX - Click X position in canvas coordinates
+     * @param clickY - Click Y position in canvas coordinates
+     * @returns true if UFO reacted to the click
+     */
+    handleClick(clickX: number, clickY: number): boolean;
+    private handleDirectHit;
+    private handleNearMiss;
+    private handleFarClick;
+    /**
+     * Command UFO to scan a nearby star
+     */
+    commandScanStar(): boolean;
+    /**
+     * Command UFO to scan the ground below
+     */
+    commandScanGround(): void;
+    /**
+     * Command UFO to pause and chill
+     */
+    commandPause(): void;
+    /**
+     * Command UFO to wander around
+     */
+    commandWander(): void;
+    /**
+     * Command UFO to drift lazily
+     */
+    commandDrift(): void;
+    /**
+     * Command UFO to leave with its preset exit type
+     */
+    commandExit(): void;
+    /**
+     * Command UFO to leave with a specific exit animation
+     */
+    commandExitWith(exitType: UFOExitType): void;
+    /**
+     * Get current entrance/exit types for UI display
+     */
+    getEntranceExitTypes(): {
+        entrance: UFOEntranceType;
+        exit: UFOExitType;
+    } | null;
+    /**
+     * Get all available entrance types
+     */
+    getAvailableEntranceTypes(): UFOEntranceType[];
+    /**
+     * Get all available exit types
+     */
+    getAvailableExitTypes(): UFOExitType[];
+    cleanup(): void;
+}
+//# sourceMappingURL=UFOSystem.d.ts.map

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

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