@austencloud/backgrounds 0.1.0

package/dist/core/contracts/IBackgroundController.d.ts

@@ -0,0 +1,122 @@
+/**
+ * IBackgroundController - Interface for the singleton background rendering controller
+ *
+ * This controller manages canvas-based background rendering outside of Svelte's
+ * reactive system. It survives HMR and provides an imperative API for background
+ * management.
+ *
+ * ## Architecture
+ *
+ * The controller owns:
+ * - Canvas elements (creates them directly in DOM)
+ * - Animation loops
+ * - Background system instances
+ * - Crossfade transitions
+ *
+ * Svelte components use this via a thin wrapper (BackgroundHost.svelte) that
+ * bridges reactive props to the controller's imperative API.
+ *
+ * ## Why This Pattern
+ *
+ * Svelte's $state resets on HMR, but canvases need persistent state.
+ * By extracting canvas management to a singleton controller that persists
+ * via import.meta.hot.data, we avoid the coordination problems between
+ * Svelte's reactivity and the DOM.
+ */
+import type { BackgroundType } from "../domain/enums.js";
+import type { QualityLevel, BackgroundEvent } from "../domain/types.js";
+/**
+ * Options for customizing background appearance.
+ * Used for solid colors and gradients.
+ */
+export interface BackgroundOptions {
+    /** Hex color for solid backgrounds (e.g., "#000000") */
+    backgroundColor?: string;
+    /** Array of hex colors for gradient backgrounds */
+    gradientColors?: string[];
+    /** Angle in degrees for gradient direction (e.g., 135) */
+    gradientDirection?: number;
+    /** Reduce quality for thumbnail previews */
+    thumbnailMode?: boolean;
+}
+/**
+ * Controller for managing background canvas rendering.
+ *
+ * @example
+ * ```typescript
+ * const controller = getBackgroundController();
+ *
+ * // Mount to a container element
+ * controller.mount(document.getElementById('background-container'));
+ *
+ * // Set the background
+ * await controller.setBackground(BackgroundType.DEEP_OCEAN);
+ *
+ * // Change background with crossfade
+ * await controller.setBackground(BackgroundType.FIREFLY_FOREST);
+ *
+ * // Cleanup when done
+ * controller.unmount();
+ * ```
+ */
+export interface IBackgroundController {
+    /**
+     * Mount the controller to a container element.
+     * Creates canvas elements inside the container.
+     *
+     * Safe to call multiple times - will verify existing canvases
+     * and recreate if needed (e.g., after HMR).
+     */
+    mount(container: HTMLElement): void;
+    /**
+     * Unmount the controller.
+     * Stops animations, cleans up systems, removes canvases.
+     *
+     * Note: In normal HMR scenarios, you typically DON'T want to unmount.
+     * Only unmount when the app is truly shutting down.
+     */
+    unmount(): void;
+    /**
+     * Set the background type with optional customization.
+     *
+     * Behavior:
+     * - If same type and already rendered: no-op (prevents flicker)
+     * - If different type: performs smooth crossfade
+     * - If currently transitioning: queues the request
+     * - If not mounted yet: stores for later initialization
+     *
+     * @returns Promise that resolves when transition completes
+     */
+    setBackground(type: BackgroundType, options?: BackgroundOptions): Promise<void>;
+    /**
+     * Set the quality level for the background.
+     * Affects particle count, blur quality, etc.
+     */
+    setQuality(quality: QualityLevel): void;
+    /**
+     * Get the currently displayed background type.
+     * Returns null if no background is set.
+     */
+    getCurrentType(): BackgroundType | null;
+    /**
+     * Check if the controller is mounted and displaying content.
+     */
+    isReady(): boolean;
+    /**
+     * Force a refresh of the current background.
+     * Useful for debugging or manual recovery from edge cases.
+     */
+    forceRefresh(): void;
+    /**
+     * Enable or disable adaptive quality.
+     * When enabled (default), quality auto-adjusts based on FPS.
+     * When disabled, quality stays at the last set level.
+     */
+    setAdaptiveQuality(enabled: boolean): void;
+    /**
+     * Register a callback for background events.
+     * Events include quality changes, errors, and performance reports.
+     */
+    onEvent(callback: (event: BackgroundEvent) => void): void;
+}
+//# sourceMappingURL=IBackgroundController.d.ts.map

package/dist/core/contracts/IBackgroundController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackgroundController.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/IBackgroundController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAEpC;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAExC;;;OAGG;IACH,cAAc,IAAI,cAAc,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;OAGG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3D"}

package/dist/core/contracts/IBackgroundController.js

@@ -0,0 +1,27 @@
+/**
+ * IBackgroundController - Interface for the singleton background rendering controller
+ *
+ * This controller manages canvas-based background rendering outside of Svelte's
+ * reactive system. It survives HMR and provides an imperative API for background
+ * management.
+ *
+ * ## Architecture
+ *
+ * The controller owns:
+ * - Canvas elements (creates them directly in DOM)
+ * - Animation loops
+ * - Background system instances
+ * - Crossfade transitions
+ *
+ * Svelte components use this via a thin wrapper (BackgroundHost.svelte) that
+ * bridges reactive props to the controller's imperative API.
+ *
+ * ## Why This Pattern
+ *
+ * Svelte's $state resets on HMR, but canvases need persistent state.
+ * By extracting canvas management to a singleton controller that persists
+ * via import.meta.hot.data, we avoid the coordination problems between
+ * Svelte's reactivity and the DOM.
+ */
+export {};
+//# sourceMappingURL=IBackgroundController.js.map

package/dist/core/contracts/IBackgroundController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackgroundController.js","sourceRoot":"","sources":["../../../src/core/contracts/IBackgroundController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/core/contracts/IBackgroundRenderingService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Service for rendering background elements and calculating particle properties
+ */
+import type { Dimensions, GradientStop } from "../domain/types.js";
+export interface IBackgroundRenderingService {
+    /**
+     * Draws a gradient background on the canvas context
+     */
+    drawGradient(ctx: CanvasRenderingContext2D, dimensions: Dimensions, gradientStops: readonly GradientStop[]): void;
+    /**
+     * Calculates the appropriate number of particles based on dimensions, density and quality
+     */
+    calculateParticleCount(dimensions: Dimensions, baseDensity: number, quality: "high" | "medium" | "low"): number;
+    /**
+     * Determines if seasonal features should be enabled based on current date
+     */
+    shouldEnableSeasonalFeatures(): boolean;
+}
+//# sourceMappingURL=IBackgroundRenderingService.d.ts.map

package/dist/core/contracts/IBackgroundRenderingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackgroundRenderingService.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/IBackgroundRenderingService.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,YAAY,CACV,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,IAAI,CAAC;IAER;;OAEG;IACH,sBAAsB,CACpB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GACjC,MAAM,CAAC;IAEV;;OAEG;IACH,4BAA4B,IAAI,OAAO,CAAC;CACzC"}

package/dist/core/contracts/IBackgroundRenderingService.js

@@ -0,0 +1,5 @@
+/**
+ * Service for rendering background elements and calculating particle properties
+ */
+export {};
+//# sourceMappingURL=IBackgroundRenderingService.js.map

package/dist/core/contracts/IBackgroundRenderingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackgroundRenderingService.js","sourceRoot":"","sources":["../../../src/core/contracts/IBackgroundRenderingService.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/contracts/IBackgroundSystem.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Background System Interface
+ *
+ * Base interface for all background animation systems.
+ * Defines the common contract that all background systems must implement.
+ */
+import type { AccessibilitySettings } from "../domain/types.js";
+import type { Dimensions, QualityLevel, PerformanceMetrics } from "../domain/types.js";
+export interface IBackgroundSystem {
+    /**
+     * Initialize the background system with dimensions and quality
+     */
+    initialize(dimensions: Dimensions, quality: QualityLevel): void;
+    /**
+     * Update the background system animation state
+     * @param dimensions - Canvas dimensions
+     * @param frameMultiplier - Optional multiplier to normalize animation speed (defaults to 1.0)
+     */
+    update(dimensions: Dimensions, frameMultiplier?: number): void;
+    /**
+     * Draw the background system to the canvas
+     */
+    draw(ctx: CanvasRenderingContext2D, dimensions: Dimensions): void;
+    /**
+     * Set the quality level for the background system
+     */
+    setQuality(quality: QualityLevel): void;
+    /**
+     * Clean up resources used by the background system
+     */
+    cleanup(): void;
+    /**
+     * Handle resize events (optional)
+     */
+    handleResize?(oldDimensions: Dimensions, newDimensions: Dimensions): void;
+    /**
+     * Set accessibility settings (optional)
+     */
+    setAccessibility?(settings: AccessibilitySettings): void;
+    /**
+     * Get performance metrics (optional)
+     */
+    getMetrics?(): PerformanceMetrics;
+}
+//# sourceMappingURL=IBackgroundSystem.d.ts.map

package/dist/core/contracts/IBackgroundSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackgroundSystem.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/IBackgroundSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,wBAAwB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,CAAC,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;IAE1E;;OAEG;IACH,gBAAgB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,UAAU,CAAC,IAAI,kBAAkB,CAAC;CACnC"}

package/dist/core/contracts/IBackgroundSystem.js

@@ -0,0 +1,8 @@
+/**
+ * Background System Interface
+ *
+ * Base interface for all background animation systems.
+ * Defines the common contract that all background systems must implement.
+ */
+export {};
+//# sourceMappingURL=IBackgroundSystem.js.map

package/dist/core/contracts/IBackgroundSystem.js.map

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

package/dist/core/contracts/IGeoLocationProvider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Geo Location Provider Interface
+ *
+ * Provides geographic coordinates for location-dependent features
+ * like moon phase calculations based on user's latitude.
+ *
+ * Consumers can provide their own implementation or use the default
+ * which assumes northern hemisphere (45° latitude).
+ */
+export interface IGeoLocationProvider {
+    getCoordinates(): Promise<{
+        latitude: number;
+        longitude: number;
+    } | null>;
+    isAvailable(): boolean;
+}
+/**
+ * Default geo location provider that returns a reasonable default
+ * for northern hemisphere users (roughly central US/Europe latitude).
+ */
+export declare class DefaultGeoLocationProvider implements IGeoLocationProvider {
+    getCoordinates(): Promise<{
+        latitude: number;
+        longitude: number;
+    } | null>;
+    isAvailable(): boolean;
+}
+//# sourceMappingURL=IGeoLocationProvider.d.ts.map

package/dist/core/contracts/IGeoLocationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGeoLocationProvider.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/IGeoLocationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,oBAAoB;IACnC,cAAc,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC1E,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IAC/D,cAAc,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAM/E,WAAW,IAAI,OAAO;CAGvB"}

package/dist/core/contracts/IGeoLocationProvider.js

@@ -0,0 +1,24 @@
+/**
+ * Geo Location Provider Interface
+ *
+ * Provides geographic coordinates for location-dependent features
+ * like moon phase calculations based on user's latitude.
+ *
+ * Consumers can provide their own implementation or use the default
+ * which assumes northern hemisphere (45° latitude).
+ */
+/**
+ * Default geo location provider that returns a reasonable default
+ * for northern hemisphere users (roughly central US/Europe latitude).
+ */
+export class DefaultGeoLocationProvider {
+    async getCoordinates() {
+        // Return a default northern hemisphere latitude for moon calculations
+        // This is roughly the latitude of central US/Europe
+        return { latitude: 45, longitude: -90 };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+//# sourceMappingURL=IGeoLocationProvider.js.map

package/dist/core/contracts/IGeoLocationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGeoLocationProvider.js","sourceRoot":"","sources":["../../../src/core/contracts/IGeoLocationProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IACrC,KAAK,CAAC,cAAc;QAClB,sEAAsE;QACtE,oDAAoD;QACpD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/domain/constants.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Background configuration constants
+ */
+import type { QualityConfig } from "./types.js";
+/**
+ * Snowfall configuration
+ */
+export declare const SnowfallConfig: {
+    readonly snowflake: {
+        readonly colors: readonly ["#ffffff", "#f8faff", "#e8f4f8", "#e6f2ff", "#f0f8ff", "#dde7ff", "#e8e8ff", "#f5f5ff", "#e0f0ff"];
+        readonly minSize: 1.5;
+        readonly maxSize: 12;
+        readonly minSpeed: 0.3;
+        readonly maxSpeed: 2.5;
+        readonly density: 0.00015;
+        readonly windChangeInterval: 400;
+    };
+    readonly shootingStar: {
+        readonly colors: readonly ["#ffffff", "#f8faff", "#e8f4f8", "#dde7ff", "#f0f8ff", "#e6f2ff", "#fff8e7"];
+        readonly minSize: 3;
+        readonly maxSize: 5;
+        readonly minSpeed: 0.012;
+        readonly maxSpeed: 0.02;
+        readonly minInterval: 8000;
+        readonly maxInterval: 20000;
+        readonly tailLength: {
+            readonly min: 50;
+            readonly max: 100;
+        };
+    };
+};
+/**
+ * Core background configuration (gradient stops)
+ */
+export declare const CoreBackgroundConfig: {
+    readonly gradientStops: readonly [{
+        readonly position: 0;
+        readonly color: "#0a0e1a";
+    }, {
+        readonly position: 0.2;
+        readonly color: "#1a1d3a";
+    }, {
+        readonly position: 0.4;
+        readonly color: "#2d2560";
+    }, {
+        readonly position: 0.65;
+        readonly color: "#1e2a4a";
+    }, {
+        readonly position: 0.85;
+        readonly color: "#0f1c3d";
+    }, {
+        readonly position: 1;
+        readonly color: "#041426";
+    }];
+};
+/**
+ * Quality level configurations
+ */
+export declare const QUALITY_CONFIGS: Record<string, QualityConfig>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/domain/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/domain/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CAyCjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;CASvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAyChD,CAAC"}

package/dist/core/domain/constants.js

@@ -0,0 +1,107 @@
+/**
+ * Background configuration constants
+ */
+/**
+ * Snowfall configuration
+ */
+export const SnowfallConfig = {
+    snowflake: {
+        colors: [
+            "#ffffff", // Pure crystalline white
+            "#f8faff", // Soft cloud white
+            "#e8f4f8", // Icy blue-white
+            "#e6f2ff", // Gentle sky blue
+            "#f0f8ff", // Alice blue
+            "#dde7ff", // Soft periwinkle
+            "#e8e8ff", // Lavender mist
+            "#f5f5ff", // Faint purple-white
+            "#e0f0ff", // Winter morning blue
+        ],
+        minSize: 1.5,
+        maxSize: 12,
+        minSpeed: 0.3,
+        maxSpeed: 2.5,
+        density: 0.00015,
+        windChangeInterval: 400,
+    },
+    shootingStar: {
+        colors: [
+            "#ffffff", // Pure white
+            "#f8faff", // Soft white
+            "#e8f4f8", // Icy blue
+            "#dde7ff", // Soft blue
+            "#f0f8ff", // Alice blue
+            "#e6f2ff", // Gentle sky
+            "#fff8e7", // Warm white
+        ],
+        minSize: 3,
+        maxSize: 5,
+        minSpeed: 0.012, // Graceful arc across sky (~1-1.5 seconds)
+        maxSpeed: 0.02,
+        minInterval: 8000,
+        maxInterval: 20000,
+        tailLength: {
+            min: 50,
+            max: 100,
+        },
+    },
+};
+/**
+ * Core background configuration (gradient stops)
+ */
+export const CoreBackgroundConfig = {
+    gradientStops: [
+        { position: 0, color: "#0a0e1a" }, // Deep midnight blue
+        { position: 0.2, color: "#1a1d3a" }, // Rich indigo
+        { position: 0.4, color: "#2d2560" }, // Deep purple-blue
+        { position: 0.65, color: "#1e2a4a" }, // Winter evening blue
+        { position: 0.85, color: "#0f1c3d" }, // Deep ocean blue
+        { position: 1, color: "#041426" }, // Deepest night
+    ],
+};
+/**
+ * Quality level configurations
+ */
+export const QUALITY_CONFIGS = {
+    "ultra-minimal": {
+        maxParticles: 5,
+        animationFrameRate: 10,
+        enableBlur: false,
+        enableGlow: false,
+        particleSize: 1,
+        densityMultiplier: 0.1,
+    },
+    minimal: {
+        maxParticles: 20,
+        animationFrameRate: 15,
+        enableBlur: false,
+        enableGlow: false,
+        particleSize: 1,
+        densityMultiplier: 0.3,
+    },
+    low: {
+        maxParticles: 50,
+        animationFrameRate: 30,
+        enableBlur: false,
+        enableGlow: false,
+        particleSize: 2,
+        densityMultiplier: 0.5,
+    },
+    medium: {
+        maxParticles: 100,
+        animationFrameRate: 45,
+        enableBlur: true,
+        enableGlow: false,
+        particleSize: 3,
+        densityMultiplier: 0.75,
+    },
+    high: {
+        maxParticles: 200,
+        animationFrameRate: 60,
+        enableBlur: true,
+        enableGlow: true,
+        particleSize: 4,
+        densityMultiplier: 1.0,
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/domain/constants.js.map

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

package/dist/core/domain/enums.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Background type enumeration
+ */
+export declare enum BackgroundType {
+    SNOWFALL = "snowfall",
+    NIGHT_SKY = "nightSky",
+    PRIDE = "pride",
+    DEEP_OCEAN = "deepOcean",
+    EMBER_GLOW = "emberGlow",
+    SAKURA_DRIFT = "sakuraDrift",
+    FIREFLY_FOREST = "fireflyForest",
+    AUTUMN_DRIFT = "autumnDrift",
+    SOLID_COLOR = "solidColor",
+    LINEAR_GRADIENT = "linearGradient"
+}
+/**
+ * Background category enumeration
+ */
+export declare enum BackgroundCategory {
+    ANIMATED = "animated",
+    SIMPLE = "simple"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/core/domain/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../src/core/domain/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,cAAc;IAExB,QAAQ,aAAa;IACrB,SAAS,aAAa;IACtB,KAAK,UAAU;IACf,UAAU,cAAc;IACxB,UAAU,cAAc;IACxB,YAAY,gBAAgB;IAC5B,cAAc,kBAAkB;IAChC,YAAY,gBAAgB;IAG5B,WAAW,eAAe;IAC1B,eAAe,mBAAmB;CACnC;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB"}

package/dist/core/domain/enums.js

@@ -0,0 +1,27 @@
+/**
+ * Background type enumeration
+ */
+export var BackgroundType;
+(function (BackgroundType) {
+    // Animated backgrounds
+    BackgroundType["SNOWFALL"] = "snowfall";
+    BackgroundType["NIGHT_SKY"] = "nightSky";
+    BackgroundType["PRIDE"] = "pride";
+    BackgroundType["DEEP_OCEAN"] = "deepOcean";
+    BackgroundType["EMBER_GLOW"] = "emberGlow";
+    BackgroundType["SAKURA_DRIFT"] = "sakuraDrift";
+    BackgroundType["FIREFLY_FOREST"] = "fireflyForest";
+    BackgroundType["AUTUMN_DRIFT"] = "autumnDrift";
+    // Simple backgrounds
+    BackgroundType["SOLID_COLOR"] = "solidColor";
+    BackgroundType["LINEAR_GRADIENT"] = "linearGradient";
+})(BackgroundType || (BackgroundType = {}));
+/**
+ * Background category enumeration
+ */
+export var BackgroundCategory;
+(function (BackgroundCategory) {
+    BackgroundCategory["ANIMATED"] = "animated";
+    BackgroundCategory["SIMPLE"] = "simple";
+})(BackgroundCategory || (BackgroundCategory = {}));
+//# sourceMappingURL=enums.js.map

package/dist/core/domain/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/core/domain/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,cAcX;AAdD,WAAY,cAAc;IACxB,uBAAuB;IACvB,uCAAqB,CAAA;IACrB,wCAAsB,CAAA;IACtB,iCAAe,CAAA;IACf,0CAAwB,CAAA;IACxB,0CAAwB,CAAA;IACxB,8CAA4B,CAAA;IAC5B,kDAAgC,CAAA;IAChC,8CAA4B,CAAA;IAE5B,qBAAqB;IACrB,4CAA0B,CAAA;IAC1B,oDAAkC,CAAA;AACpC,CAAC,EAdW,cAAc,KAAd,cAAc,QAczB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;AACnB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B"}

package/dist/core/domain/models.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Core model interfaces for the background system
+ */
+import type { Dimensions, QualityLevel, PerformanceMetrics, AccessibilitySettings } from "./types.js";
+/**
+ * Animation component interface - stateful components that render to canvas
+ */
+export interface AnimationComponent {
+    initialize: (dimensions: Dimensions, quality: QualityLevel) => void;
+    update: (dimensions: Dimensions) => void;
+    draw: (ctx: CanvasRenderingContext2D, dimensions: Dimensions) => void;
+    cleanup: () => void;
+    setQuality: (quality: QualityLevel) => void;
+    setAccessibility?: (settings: AccessibilitySettings) => void;
+}
+/**
+ * Animation system interface - functional pattern for stateless systems
+ */
+export interface AnimationSystem<T> {
+    initialize: (dimensions: Dimensions, quality: QualityLevel) => T;
+    update: (state: T, dimensions: Dimensions) => T;
+    draw: (state: T, ctx: CanvasRenderingContext2D, dimensions: Dimensions) => void;
+    cleanup?: () => void;
+    setQuality?: (quality: QualityLevel) => void;
+    adjustToResize?: (state: T, oldDimensions: Dimensions, newDimensions: Dimensions, quality: QualityLevel) => T;
+    setAccessibility?: (settings: AccessibilitySettings) => void;
+}
+/**
+ * Background system interface - the main contract all backgrounds implement
+ */
+export interface BackgroundSystem {
+    initialize: (dimensions: Dimensions, quality: QualityLevel) => void;
+    update: (dimensions: Dimensions, frameMultiplier?: number) => void;
+    draw: (ctx: CanvasRenderingContext2D, dimensions: Dimensions) => void;
+    setQuality: (quality: QualityLevel) => void;
+    cleanup: () => void;
+    handleResize?: (oldDimensions: Dimensions, newDimensions: Dimensions) => void;
+    setAccessibility?: (settings: AccessibilitySettings) => void;
+    getMetrics?: () => PerformanceMetrics;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/core/domain/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/core/domain/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,IAAI,EAAE,CAAC,GAAG,EAAE,wBAAwB,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,KAAK,CAAC,CAAC;IACjE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,KAAK,CAAC,CAAC;IAChD,IAAI,EAAE,CACJ,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,wBAAwB,EAC7B,UAAU,EAAE,UAAU,KACnB,IAAI,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,cAAc,CAAC,EAAE,CACf,KAAK,EAAE,CAAC,EACR,aAAa,EAAE,UAAU,EACzB,aAAa,EAAE,UAAU,EACzB,OAAO,EAAE,YAAY,KAClB,CAAC,CAAC;IACP,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,IAAI,EAAE,CAAC,GAAG,EAAE,wBAAwB,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACtE,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9E,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,kBAAkB,CAAC;CACvC"}

package/dist/core/domain/models.js

@@ -0,0 +1,5 @@
+/**
+ * Core model interfaces for the background system
+ */
+export {};
+//# sourceMappingURL=models.js.map

package/dist/core/domain/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/core/domain/models.ts"],"names":[],"mappings":"AAAA;;GAEG"}