@canvasengine/presets 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import * as canvasengine from 'canvasengine';
+
+interface BarProps {
+    backgroundColor?: string;
+    foregroundColor?: string;
+    value: number;
+    maxValue: number;
+    width: number;
+    height: number;
+    border?: any;
+    innerMargin?: number;
+    borderRadius?: number;
+}
+declare function Bar(opts: BarProps): canvasengine.Element<canvasengine.ComponentInstance>;
+
+declare function Particle(options: any): canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+
+declare function LightSpot(opts: any): canvasengine.Element<canvasengine.ComponentInstance>;
+declare function NightAmbiant(props: any): canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+
+interface JoystickChangeEvent {
+    angle: number;
+    direction: Direction;
+    power: number;
+}
+declare enum Direction {
+    LEFT = "left",
+    TOP = "top",
+    BOTTOM = "bottom",
+    RIGHT = "right",
+    TOP_LEFT = "top_left",
+    TOP_RIGHT = "top_right",
+    BOTTOM_LEFT = "bottom_left",
+    BOTTOM_RIGHT = "bottom_right"
+}
+interface JoystickSettings {
+    outer?: string;
+    inner?: string;
+    outerScale?: {
+        x: number;
+        y: number;
+    };
+    innerScale?: {
+        x: number;
+        y: number;
+    };
+    onChange?: (data: JoystickChangeEvent) => void;
+    onStart?: () => void;
+    onEnd?: () => void;
+}
+declare function Joystick(opts?: JoystickSettings): canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+
+declare function TiledMap(props: any): canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+
+/**
+ * Weather Effect Component
+ *
+ * Creates a realistic rain effect using WebGL shaders with customizable parameters.
+ * The effect simulates raindrops falling with wind influence, density control, and speed adjustment.
+ *
+ * ## Design
+ *
+ * The component uses a fragment shader to generate procedural rain drops with:
+ * - **Procedural generation**: Each raindrop is generated using hash functions for randomness
+ * - **Wind simulation**: Raindrops are affected by wind direction and strength as they fall
+ * - **Density control**: Number of visible raindrops can be adjusted
+ * - **Speed variation**: Each drop has slightly different falling speed for realism
+ * - **Visual styling**: Zelda-inspired rain appearance with proper fade effects
+ *
+ * @param {Object} options - Configuration options for the weather effect
+ * @param {number} [options.speed=0.5] - Rain falling speed (0.1 = slow, 2.0 = fast)
+ * @param {number} [options.windDirection=0.0] - Wind direction (-1.0 = left, 1.0 = right)
+ * @param {number} [options.windStrength=0.2] - Wind strength (0.0 = no wind, 1.0 = strong)
+ * @param {number} [options.density=180.0] - Rain density (number of raindrops, 50-400)
+ * @param {Array<number>} [options.resolution=[1000, 1000]] - Screen resolution for proper scaling
+ *
+ * @example
+ * ```jsx
+ * // Basic usage with default settings
+ * <Weather />
+ *
+ * // Customized heavy rain with strong wind
+ * <Weather
+ *   speed={1.5}
+ *   windDirection={0.8}
+ *   windStrength={0.6}
+ *   density={300}
+ * />
+ *
+ * // Light drizzle
+ * <Weather
+ *   speed={0.2}
+ *   density={80}
+ *   windStrength={0.1}
+ * />
+ *
+ * // Using signals for dynamic control
+ * const rainSpeed = signal(0.5);
+ * const windDir = signal(0.0);
+ *
+ * <Weather
+ *   speed={rainSpeed}
+ *   windDirection={windDir}
+ * />
+ * ```
+ *
+ * @returns {JSX.Element} A mesh component with the weather shader effect
+ */
+declare const WeatherEffect: (options: any) => canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+declare const Weather: (options: any) => canvasengine.Element<canvasengine.ComponentInstance> | Promise<canvasengine.Element<canvasengine.ComponentInstance>>;
+
+export { Bar, Direction, Joystick, type JoystickChangeEvent, type JoystickSettings, LightSpot, NightAmbiant, Particle, TiledMap, Weather, WeatherEffect };