@austencloud/backgrounds 0.1.0

package/dist/core/services/BackgroundFactory.js

@@ -0,0 +1,164 @@
+/**
+ * Background Factory
+ *
+ * Creates background animation systems with lazy loading.
+ * Each background type is loaded on-demand to reduce initial bundle size.
+ */
+import { BackgroundType } from "../domain/enums.js";
+// Lazy loaders for background systems
+const backgroundLoaders = {
+    pride: () => import("../../backgrounds/rainbow/services/RainbowBackgroundSystem.js"),
+    snowfall: () => import("../../backgrounds/snowfall/services/SnowfallBackgroundSystem.js"),
+    nightSky: () => import("../../backgrounds/night-sky/services/NightSkyBackgroundSystem.js"),
+    deepOcean: () => import("../../backgrounds/deep-ocean/services/DeepOceanBackgroundOrchestrator.js"),
+    emberGlow: () => import("../../backgrounds/ember-glow/services/EmberGlowBackgroundSystem.js"),
+    cherryBlossom: () => import("../../backgrounds/cherry-blossom/services/CherryBlossomBackgroundSystem.js"),
+    fireflyForest: () => import("../../backgrounds/firefly-forest/services/FireflyForestBackgroundSystem.js"),
+    autumnDrift: () => import("../../backgrounds/autumn-drift/services/AutumnDriftBackgroundSystem.js"),
+    simple: () => import("../../backgrounds/simple/services/SimpleBackgroundSystem.js"),
+};
+export class BackgroundFactory {
+    // Default accessibility settings
+    static defaultAccessibility = {
+        reducedMotion: false,
+        highContrast: false,
+        visibleParticleSize: 2,
+    };
+    static async createBackgroundSystem(options) {
+        const quality = options.initialQuality;
+        // Accessibility detection for window environments
+        const accessibility = {
+            ...this.defaultAccessibility,
+            ...(options.accessibility ?? {}),
+        };
+        // Check for reduced motion preference
+        if (typeof window !== "undefined") {
+            try {
+                const prefersReducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)");
+                if (prefersReducedMotion.matches) {
+                    accessibility.reducedMotion = true;
+                }
+            }
+            catch (_error) {
+                console.warn("Could not detect reduced motion preference:", _error);
+            }
+        }
+        let backgroundSystem;
+        // Switch statement for background types - with lazy loading
+        switch (options.type) {
+            case BackgroundType.PRIDE: {
+                const { RainbowBackgroundSystem } = await backgroundLoaders.pride();
+                backgroundSystem = new RainbowBackgroundSystem();
+                break;
+            }
+            case BackgroundType.SNOWFALL: {
+                const { SnowfallBackgroundSystem } = await backgroundLoaders.snowfall();
+                backgroundSystem = new SnowfallBackgroundSystem();
+                break;
+            }
+            case BackgroundType.NIGHT_SKY: {
+                const { NightSkyBackgroundSystem } = await backgroundLoaders.nightSky();
+                backgroundSystem = NightSkyBackgroundSystem.create();
+                break;
+            }
+            case BackgroundType.DEEP_OCEAN: {
+                const { DeepOceanBackgroundOrchestrator } = await backgroundLoaders.deepOcean();
+                backgroundSystem = DeepOceanBackgroundOrchestrator.create();
+                break;
+            }
+            case BackgroundType.EMBER_GLOW: {
+                const { EmberGlowBackgroundSystem } = await backgroundLoaders.emberGlow();
+                backgroundSystem = new EmberGlowBackgroundSystem();
+                break;
+            }
+            case BackgroundType.SAKURA_DRIFT: {
+                const { CherryBlossomBackgroundSystem } = await backgroundLoaders.cherryBlossom();
+                backgroundSystem = new CherryBlossomBackgroundSystem();
+                break;
+            }
+            case BackgroundType.FIREFLY_FOREST: {
+                const { FireflyForestBackgroundSystem } = await backgroundLoaders.fireflyForest();
+                backgroundSystem = new FireflyForestBackgroundSystem();
+                break;
+            }
+            case BackgroundType.AUTUMN_DRIFT: {
+                const { AutumnDriftBackgroundSystem } = await backgroundLoaders.autumnDrift();
+                backgroundSystem = new AutumnDriftBackgroundSystem();
+                break;
+            }
+            case BackgroundType.SOLID_COLOR: {
+                const { SimpleBackgroundSystem } = await backgroundLoaders.simple();
+                backgroundSystem = new SimpleBackgroundSystem({
+                    type: "solid",
+                    color: options.backgroundColor ?? "#1a1a2e",
+                });
+                break;
+            }
+            case BackgroundType.LINEAR_GRADIENT: {
+                const { SimpleBackgroundSystem } = await backgroundLoaders.simple();
+                backgroundSystem = new SimpleBackgroundSystem({
+                    type: "gradient",
+                    colors: options.gradientColors ?? ["#667eea", "#764ba2"],
+                    direction: options.gradientDirection ?? 135,
+                });
+                break;
+            }
+            default: {
+                console.warn(`Background type "${String(options.type)}" not implemented. Defaulting to Pride.`);
+                const { RainbowBackgroundSystem } = await backgroundLoaders.pride();
+                backgroundSystem = new RainbowBackgroundSystem();
+            }
+        }
+        // Apply accessibility settings if the background system supports them
+        if (backgroundSystem.setAccessibility) {
+            backgroundSystem.setAccessibility(accessibility);
+        }
+        // Apply thumbnail mode if specified and supported
+        if (options.thumbnailMode && "setThumbnailMode" in backgroundSystem) {
+            backgroundSystem.setThumbnailMode(true);
+        }
+        // Set initial quality
+        backgroundSystem.setQuality(quality);
+        return backgroundSystem;
+    }
+    static async createOptimalBackgroundSystem() {
+        // Default to Pride as the default background
+        return await this.createBackgroundSystem({
+            type: BackgroundType.PRIDE,
+            quality: "medium",
+            initialQuality: "medium",
+        });
+    }
+    static isBackgroundSupported(type) {
+        switch (type) {
+            case BackgroundType.SNOWFALL:
+            case BackgroundType.NIGHT_SKY:
+            case BackgroundType.PRIDE:
+            case BackgroundType.DEEP_OCEAN:
+            case BackgroundType.EMBER_GLOW:
+            case BackgroundType.SAKURA_DRIFT:
+            case BackgroundType.FIREFLY_FOREST:
+            case BackgroundType.AUTUMN_DRIFT:
+            case BackgroundType.SOLID_COLOR:
+            case BackgroundType.LINEAR_GRADIENT:
+                return true;
+            default:
+                return false;
+        }
+    }
+    static getSupportedBackgroundTypes() {
+        return [
+            BackgroundType.NIGHT_SKY,
+            BackgroundType.SNOWFALL,
+            BackgroundType.PRIDE,
+            BackgroundType.DEEP_OCEAN,
+            BackgroundType.EMBER_GLOW,
+            BackgroundType.SAKURA_DRIFT,
+            BackgroundType.FIREFLY_FOREST,
+            BackgroundType.AUTUMN_DRIFT,
+            BackgroundType.SOLID_COLOR,
+            BackgroundType.LINEAR_GRADIENT,
+        ];
+    }
+}
+//# sourceMappingURL=BackgroundFactory.js.map

package/dist/core/services/BackgroundFactory.js.map

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

package/dist/core/services/BackgroundRenderingService.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Background Rendering Service
+ *
+ * Provides utility functions for rendering gradients and calculating particle properties.
+ */
+import type { IBackgroundRenderingService } from "../contracts/IBackgroundRenderingService.js";
+import type { Dimensions, GradientStop } from "../domain/types.js";
+export declare class BackgroundRenderingService implements IBackgroundRenderingService {
+    drawGradient(ctx: CanvasRenderingContext2D, dimensions: Dimensions, gradientStops: readonly GradientStop[]): void;
+    calculateParticleCount(dimensions: Dimensions, baseDensity: number, quality: "high" | "medium" | "low"): number;
+    shouldEnableSeasonalFeatures(): boolean;
+}
+export declare function getBackgroundRenderingService(): BackgroundRenderingService;
+//# sourceMappingURL=BackgroundRenderingService.d.ts.map

package/dist/core/services/BackgroundRenderingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundRenderingService.d.ts","sourceRoot":"","sources":["../../../src/core/services/BackgroundRenderingService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEnE,qBAAa,0BAA2B,YAAW,2BAA2B;IAC5E,YAAY,CACV,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,IAAI;IAeP,sBAAsB,CACpB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GACjC,MAAM;IAkBT,4BAA4B,IAAI,OAAO;CAQxC;AAKD,wBAAgB,6BAA6B,IAAI,0BAA0B,CAK1E"}

package/dist/core/services/BackgroundRenderingService.js

@@ -0,0 +1,47 @@
+/**
+ * Background Rendering Service
+ *
+ * Provides utility functions for rendering gradients and calculating particle properties.
+ */
+export class BackgroundRenderingService {
+    drawGradient(ctx, dimensions, gradientStops) {
+        const gradient = ctx.createLinearGradient(0, 0, 0, dimensions.height);
+        gradientStops.forEach((stop) => {
+            // Ensure position is a valid number between 0 and 1
+            const position = isFinite(stop.position)
+                ? Math.max(0, Math.min(1, stop.position))
+                : 0;
+            gradient.addColorStop(position, stop.color);
+        });
+        ctx.fillStyle = gradient;
+        ctx.fillRect(0, 0, dimensions.width, dimensions.height);
+    }
+    calculateParticleCount(dimensions, baseDensity, quality) {
+        let adjustedDensity = baseDensity;
+        const screenSizeFactor = Math.min(1, (dimensions.width * dimensions.height) / (1920 * 1080));
+        adjustedDensity *= screenSizeFactor;
+        if (quality === "low") {
+            adjustedDensity *= 0.5;
+        }
+        else if (quality === "medium") {
+            adjustedDensity *= 0.75;
+        }
+        return Math.floor(dimensions.width * dimensions.height * adjustedDensity);
+    }
+    shouldEnableSeasonalFeatures() {
+        const date = new Date();
+        const month = date.getMonth();
+        const day = date.getDate();
+        // December or first week of January
+        return month === 11 || (month === 0 && day <= 7);
+    }
+}
+// Singleton instance for internal use
+let renderingServiceInstance = null;
+export function getBackgroundRenderingService() {
+    if (!renderingServiceInstance) {
+        renderingServiceInstance = new BackgroundRenderingService();
+    }
+    return renderingServiceInstance;
+}
+//# sourceMappingURL=BackgroundRenderingService.js.map

package/dist/core/services/BackgroundRenderingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundRenderingService.js","sourceRoot":"","sources":["../../../src/core/services/BackgroundRenderingService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,OAAO,0BAA0B;IACrC,YAAY,CACV,GAA6B,EAC7B,UAAsB,EACtB,aAAsC;QAEtC,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAEtE,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,oDAAoD;YACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACtC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC,CAAC,CAAC,CAAC;YACN,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC;QACzB,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,sBAAsB,CACpB,UAAsB,EACtB,WAAmB,EACnB,OAAkC;QAElC,IAAI,eAAe,GAAG,WAAW,CAAC;QAElC,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAC/B,CAAC,EACD,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CACvD,CAAC;QACF,eAAe,IAAI,gBAAgB,CAAC;QAEpC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,eAAe,IAAI,GAAG,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,eAAe,IAAI,IAAI,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAC5E,CAAC;IAED,4BAA4B;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE3B,oCAAoC;QACpC,OAAO,KAAK,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;CACF;AAED,sCAAsC;AACtC,IAAI,wBAAwB,GAAsC,IAAI,CAAC;AAEvE,MAAM,UAAU,6BAA6B;IAC3C,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,wBAAwB,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/dist/core/services/MoonRenderer.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MoonRenderer - Unified Moon System
+ *
+ * Features:
+ * - Stylized procedural moon with recognizable lunar features
+ * - Lunar maria (dark "seas") and prominent craters including Tycho with rays
+ * - Real lunar cycle calculations (shows actual current moon phase)
+ * - Configurable color temperature (warm/cool tint)
+ * - Smooth glow with no banding
+ */
+import type { Dimensions } from "../domain/types.js";
+export type MoonType = "realistic" | "full" | "crescent";
+export type MoonColorTemp = "warm" | "cool";
+export interface MoonConfig {
+    type: MoonType;
+    x: number;
+    y: number;
+    radiusFraction: number;
+    maxRadius: number;
+    glowIntensity: number;
+    useRealPhase: boolean;
+    staticPhase: number;
+    colorTemp: MoonColorTemp;
+    animated: boolean;
+    crescentRotation: number;
+    detailLevel: number;
+    surfaceDarkness: number;
+    featureSpread: number;
+}
+export interface MoonState {
+    x: number;
+    y: number;
+    radius: number;
+    phase: number;
+    illuminationFraction: number;
+    isWaxing: boolean;
+    visible: boolean;
+}
+export declare class MoonRenderer {
+    private config;
+    private state;
+    private width;
+    private height;
+    private colors;
+    private animationPhase;
+    constructor(width?: number, height?: number, config?: Partial<MoonConfig>);
+    private calculateState;
+    private calculateRealLunarPhase;
+    render(ctx: CanvasRenderingContext2D): void;
+    private drawGlow;
+    private drawMoonWithTexture;
+    private drawLunarMaria;
+    private drawMare;
+    private drawCraters;
+    private drawCrater;
+    private drawCraterRays;
+    private drawTychoRays;
+    private drawPhaseShadow;
+    initialize(width: number, height: number): void;
+    update(frameMultiplier?: number): void;
+    draw(ctx: CanvasRenderingContext2D, _dimensions?: Dimensions): void;
+    resize(width: number, height: number): void;
+    setConfig(config: Partial<MoonConfig>): void;
+    setVisible(visible: boolean): void;
+    getState(): MoonState;
+    getConfig(): MoonConfig;
+    getPhaseName(): string;
+    getIlluminationPercent(): number;
+    cleanup(): void;
+    refreshPhase(): void;
+}
+/** Create a full moon with texture (for cherry blossom, etc) */
+export declare function createFullMoon(options?: Partial<MoonConfig>): MoonRenderer;
+/** Create a crescent moon (for firefly forest, etc) */
+export declare function createCrescentMoon(options?: Partial<MoonConfig>): MoonRenderer;
+/** Create a moon that shows real lunar phase */
+export declare function createRealisticMoon(options?: Partial<MoonConfig>): MoonRenderer;
+//# sourceMappingURL=MoonRenderer.d.ts.map

package/dist/core/services/MoonRenderer.d.ts.map

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