@rippleflow/water-distortion 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RippleFlow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# RippleFlow Water Distortion
+
+A React + Vite + TypeScript package for cursor-driven water on portfolio-style interfaces. RippleFlow now uses a low-resolution heightfield simulation: pointer movement stamps local trough/ridge wakes, the wave equation propagates them outward, and a WebGL material turns the heightfield into refraction, specular highlights, crests, and experimental ripple-driven caustic light.
+
+Foreground content stays sharp and interactive. Background content can be sampled directly by WebGL in `texture` / `canvas` mode for the strongest refraction, or rendered as live DOM in `dom` mode.
+
+## Install
+
+```bash
+npm install @rippleflow/water-distortion
+```
+
+React and React DOM are peer dependencies:
+
+```bash
+npm install react react-dom
+```
+
+## Usage
+
+```tsx
+import { WaterDistortion } from "@rippleflow/water-distortion";
+
+export function Hero() {
+  return (
+    <WaterDistortion
+      mode="texture"
+      wakeStrength={0.54}
+      interactionRadius={25}
+      troughStrength={0.92}
+      ridgeStrength={0.46}
+      ridgeOffset={10}
+      wakeLength={84}
+      velocityScale={1}
+      velocityClamp={1.35}
+      cursorSmoothing={0.2}
+      segmentSpacing={18}
+      damping={0.98}
+      waveSpeed={0.4}
+      normalScale={20}
+      refractionStrength={0.7}
+      specularIntensity={1}
+      crestIntensity={0.2}
+      causticIntensity={0}
+      simulationResolution={192}
+      texture="/work-collage.jpg"
+      underlay={
+        <img
+          src="/work-collage.jpg"
+          alt=""
+          style={{ width: "100%", height: "100%", objectFit: "cover" }}
+        />
+      }
+      style={{ minHeight: 620 }}
+    >
+      <section>
+        <h1>Portfolio title stays crisp</h1>
+        <a href="/work">View work</a>
+      </section>
+    </WaterDistortion>
+  );
+}
+```
+
+For true shader refraction, provide a texture source:
+
+```tsx
+<WaterDistortion
+  mode="texture"
+  texture="/hero-background.jpg"
+  wakeStrength={0.8}
+  underlay={<img src="/hero-background.jpg" alt="" />}
+>
+  <HeroCopy />
+</WaterDistortion>
+```
+
+`WaterLayer` is exported as an alias of `WaterDistortion`.
+
+## React API
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `underlay` | `ReactNode` | `undefined` | Live DOM/background content behind the water. Recommended in `dom` mode and useful as a fallback in texture modes. |
+| `children` | `ReactNode` | `undefined` | Foreground content rendered above the water. |
+| `foreground` | `ReactNode` | `undefined` | Explicit foreground prop; takes precedence over `children`. |
+| `mode` | `"dom" \| "texture" \| "canvas"` | `"texture"` | Chooses live-DOM overlay mode or true WebGL background sampling. |
+| `texture` | `TexImageSource \| string` | `undefined` | Image/canvas/video source sampled by WebGL in `texture` or `canvas` mode. URL strings are loaded with `crossOrigin="anonymous"`. |
+| `interactionMode` | `"move" \| "click" \| "drag" \| "event"` | `"move"` | Chooses pointer-movement wakes, one ripple per pointer down, press ripples plus held-drag wakes, or programmatic ripples only. |
+| `runInBackground` | `boolean` | `false` | Continues stepping while hidden or unfocused and catches up elapsed time when the browser throttles background callbacks. |
+| `pauseKey` | `string` | `undefined` | Toggles simulation pausing when this [`KeyboardEvent.code`](https://developer.mozilla.org/docs/Web/API/KeyboardEvent/code) is pressed, such as `Space` or `KeyP`. Keyboard input in interactive controls is ignored. |
+| `wakeStrength` | `number` | `0.54` | Overall pointer wake strength. Slow drags stay subtle; fast movement is clamped before it reaches the shader. |
+| `rippleStrength` | `number` | `undefined` | Compatibility alias for `wakeStrength`. |
+| `strength` | `number` | `undefined` | Legacy alias mapped to `wakeStrength` as `strength / 48`. |
+| `interactionRadius` | `number` | `25` | Width in CSS pixels of the moving virtual finger/body that parts the water. |
+| `troughStrength` | `number` | `0.92` | Strength of the narrow negative trough along the pointer path. |
+| `ridgeStrength` | `number` | `0.46` | Strength of the paired side ridges beside the trough. |
+| `ridgeOffset` | `number` | `10` | Side-ridge offset from the path centerline in CSS pixels. |
+| `wakeLength` | `number` | `84` | Base trailing wake length in CSS pixels. Fast movement scales it longer. |
+| `velocityScale` | `number` | `1` | Multiplier applied before pointer speed is clamped. |
+| `velocityClamp` | `number` | `1.35` | Pointer speed in CSS pixels per millisecond that maps to full wake strength. |
+| `cursorSmoothing` | `number` | `0.2` | Low-pass smoothing for the virtual finger position and speed. |
+| `segmentSpacing` | `number` | `18` | Maximum CSS-pixel spacing before long pointer moves are subdivided into connected wake segments. |
+| `damping` | `number` | `0.98` | Per-step velocity damping. Higher values let waves travel longer. |
+| `dissipation` | `number` | `undefined` | Legacy alias for `damping`. |
+| `waveSpeed` | `number` | `0.4` | Stiffness of the damped wave equation. |
+| `normalScale` | `number` | `20` | Height-gradient scale used to compute visible water normals. |
+| `refractionStrength` | `number` | `0.7` | Amount of normal-driven texture displacement in texture/canvas modes. |
+| `specularIntensity` | `number` | `1` | Strength of fixed-light specular highlights. |
+| `crestIntensity` | `number` | `0.2` | Visibility of height-gradient crests and troughs. |
+| `causticIntensity` | `number` | `0` | Experimental ripple-driven caustic light that fades when the simulated surface is calm. |
+| `simulationResolution` | `number` | `192` | Longest side of the simulation texture. Clamped to `64...384`. |
+| `idleTimeout` | `number` | `900` | Minimum active time after input before the renderer begins checking whether ripples have faded enough to sleep. |
+| `className` | `string` | `undefined` | Applied to the container. |
+| `style` | `CSSProperties` | `undefined` | Merged onto the container. The component enforces relative positioning, hidden overflow, and isolation. |
+| `reducedMotion` | `"respect" \| "disable" \| "ignore"` | `"respect"` | `respect` disables wave input when `prefers-reduced-motion: reduce` matches. |
+
+Programmatic ripples use normalized container coordinates through the component ref:
+
+~~~tsx
+import { useEffect, useRef } from "react";
+import {
+  WaterDistortion,
+  type WaterDistortionHandle
+} from "@rippleflow/water-distortion";
+
+function EventDrivenWater() {
+  const waterRef = useRef<WaterDistortionHandle>(null);
+
+  useEffect(() => {
+    waterRef.current?.triggerRipple({ x: 0.5, y: 0.5 });
+  }, []);
+
+  return <WaterDistortion ref={waterRef} interactionMode="event" />;
+}
+~~~
+
+The older `blur`, `maxTrailPoints`, `maxStamps`, and `trailSpacing` props remain accepted for source compatibility, but the heightfield renderer does not use the old trail-stamp engine.
+
+## Modes
+
+### `dom`
+
+Use `dom` when the background is arbitrary live React/DOM content. The DOM underlay is rendered normally, foreground content stays sharp, and the WebGL canvas draws transparent water highlights derived from the heightfield.
+
+Browsers do not provide an efficient, general API for sampling arbitrary live DOM into WebGL every frame. RippleFlow therefore does not pretend to perform perfect DOM refraction. The visible water material comes from heightfield normals, specular, crest, and caustic lighting, so ripples remain readable even when the DOM itself is not displaced.
+
+### `texture` / `canvas`
+
+Use `texture` or `canvas` when you can provide an image, video, canvas, or URL that WebGL can sample. This path gives the best visual quality because the shader offsets the sampled background with `normal.xy` from the water heightfield.
+
+If no `texture` is supplied in these modes, RippleFlow renders a procedural gradient background so the playground and demos still show true refraction.
+
+## How It Works
+
+- A WebGL renderer maintains two ping-pong floating-point simulation textures.
+- Each texel stores height and velocity.
+- Every fixed step samples neighboring heights, accelerates velocity toward the neighbor average, applies damping, and integrates height.
+- Pointer input uses `pointermove` plus `getCoalescedEvents()` where available, then low-pass filters samples into a virtual cursor.
+- Pointer movement is stamped as continuous SDF/capsule wake segments, not repeated timed circles.
+- Each segment uses a directional profile: center trough, paired side ridges, a trailing wake mask, and subtle behind-only wavelets.
+- The material pass computes normals from height gradients, then combines refraction, specular highlights, crest/trough visibility, and projected caustic light that fades with ripple activity.
+- The animation loop runs while input is active, then sleeps after ripples measure as visually quiet.
+
+## Performance Notes
+
+- The simulation resolution defaults to `192`, while the visible canvas still matches the container size.
+- Keep `simulationResolution` around `128...256` for most portfolio hero sections.
+- The renderer uses refs and an imperative animation loop; React state is not updated per frame.
+- `ResizeObserver` keeps the canvas responsive.
+- `IntersectionObserver` and `document.visibilityState` pause offscreen or hidden work when available.
+- `toDataURL()` is not used in the primary render path.
+- Dynamic canvas/video texture sources may be uploaded each rendered frame in `canvas`/`texture` mode.
+- `prefers-reduced-motion` is respected by default.
+
+## Browser Notes
+
+The primary path uses WebGL2 with floating-point render targets. A WebGL1 path is attempted when float textures and float color buffers are available. Current Chrome, Safari, and Firefox support the WebGL2 path on modern desktop systems; older browsers or restricted GPU environments may fall back to showing only the underlay and foreground.
+
+Useful APIs:
+
+- WebGL2: https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext
+- PointerEvent.getCoalescedEvents(): https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/getCoalescedEvents
+- ResizeObserver: https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver
+- IntersectionObserver: https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver
+
+## Demo
+
+```bash
+npm install
+npm run dev
+```
+
+Open the local Vite URL and move across the hero. The `/playground` controls adjust wake shape, smoothing, segment spacing, damping, wave speed, normal scale, refraction, specular, crest/caustic intensity, and simulation resolution.
+
+## Quality
+
+```bash
+npm test
+npm run typecheck
+npm run build
+```

package/dist/WaterDistortion.d.ts

@@ -0,0 +1,56 @@
+import type { CSSProperties, ReactNode } from "react";
+import { type WaterRenderMode, type WaterTextureSource } from "./core/waterRenderer";
+export type ReducedMotionBehavior = "respect" | "disable" | "ignore";
+export type WaterInteractionMode = "move" | "click" | "drag" | "event";
+export interface WaterRipplePosition {
+    /** Horizontal position normalized from 0 (left) to 1 (right). */
+    x: number;
+    /** Vertical position normalized from 0 (top) to 1 (bottom). */
+    y: number;
+}
+export interface WaterDistortionHandle {
+    triggerRipple(position: WaterRipplePosition): void;
+}
+export interface WaterDistortionProps {
+    underlay?: ReactNode;
+    children?: ReactNode;
+    foreground?: ReactNode;
+    mode?: WaterRenderMode;
+    texture?: WaterTextureSource;
+    rippleStrength?: number;
+    wakeStrength?: number;
+    interactionRadius?: number;
+    troughStrength?: number;
+    ridgeStrength?: number;
+    ridgeOffset?: number;
+    wakeLength?: number;
+    velocityScale?: number;
+    velocityClamp?: number;
+    cursorSmoothing?: number;
+    segmentSpacing?: number;
+    strength?: number;
+    damping?: number;
+    dissipation?: number;
+    waveSpeed?: number;
+    normalScale?: number;
+    refractionStrength?: number;
+    specularIntensity?: number;
+    crestIntensity?: number;
+    causticIntensity?: number;
+    simulationResolution?: number;
+    idleTimeout?: number;
+    blur?: number;
+    maxTrailPoints?: number;
+    maxStamps?: number;
+    trailSpacing?: number;
+    className?: string;
+    style?: CSSProperties;
+    reducedMotion?: ReducedMotionBehavior;
+    interactionMode?: WaterInteractionMode;
+    runInBackground?: boolean;
+    pauseKey?: string;
+}
+export declare const WaterDistortion: import("react").ForwardRefExoticComponent<WaterDistortionProps & import("react").RefAttributes<WaterDistortionHandle>>;
+export declare const WaterLayer: import("react").ForwardRefExoticComponent<WaterDistortionProps & import("react").RefAttributes<WaterDistortionHandle>>;
+export type { WaterRenderMode, WaterTextureSource };
+//# sourceMappingURL=WaterDistortion.d.ts.map

package/dist/WaterDistortion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaterDistortion.d.ts","sourceRoot":"","sources":["../src/WaterDistortion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAStD,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,CAAC,EAAE,MAAM,CAAC;IACV,+DAA+D;IAC/D,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkOD,eAAO,MAAM,eAAe,wHAwqB1B,CAAC;AAEH,eAAO,MAAM,UAAU,wHAAkB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/math.d.ts

@@ -0,0 +1,10 @@
+export interface Vector2 {
+    x: number;
+    y: number;
+}
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function distance(a: Vector2, b: Vector2): number;
+export declare function lerp(a: number, b: number, amount: number): number;
+export declare function normalize(vector: Vector2): Vector2;
+export declare function smoothVector(previous: Vector2, next: Vector2, amount: number): Vector2;
+//# sourceMappingURL=math.d.ts.map

package/dist/core/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/core/math.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAWlD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAKT"}

package/dist/core/trailEngine.d.ts

@@ -0,0 +1,46 @@
+export interface TrailPoint {
+    x: number;
+    y: number;
+    t: number;
+}
+export interface TrailStamp {
+    active: boolean;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    strength: number;
+    radius: number;
+    stretch: number;
+    ageMs: number;
+}
+export interface TrailEngineOptions {
+    width: number;
+    height: number;
+    dissipation: number;
+    maxStamps: number;
+    maxTrailPoints: number;
+    trailSpacing: number;
+}
+export declare class WaterTrailEngine {
+    private options;
+    private points;
+    private stampPool;
+    private nextStampIndex;
+    private lastStampPoint;
+    private smoothedVelocity;
+    private lastStepTime;
+    constructor(options?: Partial<TrailEngineOptions>);
+    configure(options: Partial<TrailEngineOptions>): void;
+    resize(width: number, height: number): void;
+    addPoint(x: number, y: number, time: number): boolean;
+    step(time: number): boolean;
+    reset(): void;
+    endStroke(): void;
+    getStamps(): readonly TrailStamp[];
+    getPoints(): readonly TrailPoint[];
+    hasVisibleStamps(): boolean;
+    private stampAlongSegment;
+    private writeStamp;
+}
+//# sourceMappingURL=trailEngine.d.ts.map

package/dist/core/trailEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailEngine.d.ts","sourceRoot":"","sources":["../../src/core/trailEngine.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAqDD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAQrD,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IA6BrD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IA+CrD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA4B3B,KAAK,IAAI,IAAI;IAWb,SAAS,IAAI,IAAI;IAMjB,SAAS,IAAI,SAAS,UAAU,EAAE;IAIlC,SAAS,IAAI,SAAS,UAAU,EAAE;IAIlC,gBAAgB,IAAI,OAAO;IAI3B,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,UAAU;CAgCnB"}

package/dist/core/waterInteraction.d.ts

@@ -0,0 +1,58 @@
+export interface PointerSample {
+    x: number;
+    y: number;
+    time: number;
+}
+export interface WaterDisturbance {
+    ax: number;
+    ay: number;
+    bx: number;
+    by: number;
+    radius: number;
+    wakeStrength: number;
+    troughStrength: number;
+    ridgeStrength: number;
+    ridgeOffset: number;
+    wakeLength: number;
+    velocity: number;
+}
+export interface PointerDisturbanceOptions {
+    width: number;
+    height: number;
+    interactionRadius: number;
+    wakeStrength: number;
+    troughStrength: number;
+    ridgeStrength: number;
+    ridgeOffset: number;
+    wakeLength: number;
+    velocityScale: number;
+    velocityClamp: number;
+    cursorSmoothing: number;
+    segmentSpacing: number;
+}
+export interface PointerEventLike {
+    clientX: number;
+    clientY: number;
+    timeStamp: number;
+    getCoalescedEvents?: () => PointerEventLike[];
+}
+export interface BoundsLike {
+    left: number;
+    top: number;
+}
+export declare function getPointerSamples(event: PointerEventLike, bounds: BoundsLike, now?: number): PointerSample[];
+export declare class PointerDisturbanceTracker {
+    private options;
+    private previous;
+    private smoothedVelocity;
+    private readonly disturbances;
+    constructor(options?: Partial<PointerDisturbanceOptions>);
+    configure(options: Partial<PointerDisturbanceOptions>): void;
+    reset(): void;
+    addSample(sample: PointerSample): readonly WaterDisturbance[];
+    private clampSample;
+    private smoothSample;
+}
+export declare function createDisturbance(from: PointerSample, to: PointerSample, velocityPxMs: number, options: Partial<PointerDisturbanceOptions>): WaterDisturbance;
+export declare function estimateSettleDuration(damping: number): number;
+//# sourceMappingURL=waterInteraction.d.ts.map

package/dist/core/waterInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waterInteraction.d.ts","sourceRoot":"","sources":["../../src/core/waterInteraction.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,gBAAgB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AA8DD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,UAAU,EAClB,GAAG,SAAkB,GACpB,aAAa,EAAE,CAajB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;gBAE3C,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM;IAI5D,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAO5D,KAAK,IAAI,IAAI;IAMb,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,gBAAgB,EAAE;IAuD7D,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;CASrB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAC1C,gBAAgB,CAwBlB;AAcD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/dist/core/waterRenderer.d.ts

@@ -0,0 +1,66 @@
+import type { WaterDisturbance } from "./waterInteraction";
+export type WaterRenderMode = "dom" | "texture" | "canvas";
+export type WaterTextureSource = TexImageSource | string;
+export interface WaterRendererSettings {
+    mode: WaterRenderMode;
+    damping: number;
+    waveSpeed: number;
+    normalScale: number;
+    refractionStrength: number;
+    specularIntensity: number;
+    crestIntensity: number;
+    causticIntensity: number;
+    simulationResolution: number;
+    texture?: WaterTextureSource;
+}
+export interface WaterActivityThresholds {
+    gradient: number;
+    curvature: number;
+    trough: number;
+    velocity: number;
+}
+export declare class HeightfieldWaterRenderer {
+    private readonly canvas;
+    private readonly gl;
+    private readonly isWebGL2;
+    private readonly canLinearFloat;
+    private readonly quadBuffer;
+    private readonly simulationProgram;
+    private readonly materialProgram;
+    private readonly backgroundTexture;
+    private readonly causticTexture;
+    private stateTextures;
+    private framebuffers;
+    private readIndex;
+    private simWidth;
+    private simHeight;
+    private cssWidth;
+    private cssHeight;
+    private textureSource;
+    private textureImage;
+    private textureReady;
+    private textureNeedsUpload;
+    private activityPixels;
+    private readonly wakeAUniforms;
+    private readonly wakeBUniforms;
+    private readonly wakeShapeUniforms;
+    constructor(canvas: HTMLCanvasElement);
+    resize(cssWidth: number, cssHeight: number, pixelRatio: number, simulationResolution: number): void;
+    setTextureSource(source: WaterTextureSource | undefined): void;
+    step(disturbances: readonly WaterDisturbance[], settings: WaterRendererSettings, delta: number): void;
+    render(settings: WaterRendererSettings, timeSeconds?: number): void;
+    hasVisibleActivity(): boolean;
+    clear(): void;
+    dispose(): void;
+    private recreateState;
+    private createStateTexture;
+    private createFramebuffer;
+    private initializeBackgroundTexture;
+    private initializeCausticTexture;
+    private uploadTextureIfNeeded;
+    private prepareQuad;
+    private setSimulationUniforms;
+    private setMaterialUniforms;
+}
+export declare function hasVisibleWaterActivity(state: ArrayLike<number>, width: number, height: number, thresholds?: WaterActivityThresholds): boolean;
+//# sourceMappingURL=waterRenderer.d.ts.map

package/dist/core/waterRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waterRenderer.d.ts","sourceRoot":"","sources":["../../src/core/waterRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqSD,qBAAa,wBAAwB;IAyBvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAxBnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAC9C,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,YAAY,CAAmD;IACvE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2C;gBAEhD,MAAM,EAAE,iBAAiB;IA0BtD,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,MAAM,GAC3B,IAAI;IA4BP,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI;IAuC9D,IAAI,CACF,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,GACZ,IAAI;IAoBP,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,WAAW,SAAI,GAAG,IAAI;IA+B9D,kBAAkB,IAAI,OAAO;IAoC7B,KAAK,IAAI,IAAI;IAmBb,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,kBAAkB;IAiD1B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,2BAA2B;IAqBnC,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,qBAAqB;IA+B7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,mBAAmB;CAwB5B;AA4OD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,uBAAqD,GAChE,OAAO,CAyCT"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { WaterDistortion, WaterLayer } from "./WaterDistortion";
+export type { ReducedMotionBehavior, WaterDistortionHandle, WaterDistortionProps, WaterInteractionMode, WaterRenderMode, WaterRipplePosition, WaterTextureSource } from "./WaterDistortion";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC"}