@3driseai/3drise-core 1.0.10 → 1.0.11

package/dist/data/effectsDefaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effectsDefaults.d.ts","sourceRoot":"","sources":["../../src/data/effectsDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKxE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAyB3F,CAAC;AACF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAyBzE,CAAC"}
+{"version":3,"file":"effectsDefaults.d.ts","sourceRoot":"","sources":["../../src/data/effectsDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKxE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAqC3F,CAAC;AACF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAqCzE,CAAC"}

package/dist/data/effectsDefaults.js

@@ -2,13 +2,13 @@
 // DEFAULTS
 // =============================================================================
 export const DEFAULT_GENERATIVE_EFFECTS = {
-    molecules: { type: 'molecules', enabled: true, intensity: 1, speed: 1, color: '#00d4ff', opacity: 0.9, atomCount: 6, orbitRadius: 1.5, atomSize: 0.08, showBonds: true, bondColor: '#ffffff', randomizeAxes: true },
-    shockwave: { type: 'shockwave', enabled: true, intensity: 1, speed: 1, color: '#ffffff', opacity: 0.8, ringCount: 2, expansionRadius: 3, thickness: 0.04, intervalSeconds: 2, rimColor: '#88ccff' },
+    molecules: { type: 'molecules', enabled: true, intensity: 1, speed: 1, color: '#00d4ff', opacity: 0.9, atomCount: 6, orbitRadius: 1.5, atomSize: 0.08, showBonds: true, bondColor: '#ffffff', randomizeAxes: true, orbital: -1, phaseColor: '#ff5a8a', cloudDensity: 1 },
+    shockwave: { type: 'shockwave', enabled: true, intensity: 1, speed: 1, color: '#ffffff', opacity: 0.8, ringCount: 2, expansionRadius: 3, thickness: 0.04, intervalSeconds: 2, rimColor: '#88ccff', shape: 0, deceleration: 0.85, instability: 0.4, dust: 0.5, condensation: 0.3 },
     aura: { type: 'aura', enabled: true, intensity: 1, speed: 1, color: '#7b2fff', opacity: 0.6, layerCount: 3, fresnelPower: 3, pulseSpeed: 1.5, innerColor: '#ffffff', outerColor: '#7b2fff', noiseAmount: 0.3, sizeMultiplier: 1.3 },
     dataStream: { type: 'dataStream', enabled: true, intensity: 1, speed: 1, color: '#00ff88', opacity: 0.85, particleCount: 150, spiralTurns: 3, streamRadius: 1.2, inward: false, particleSize: 0.04, coldColor: '#0d26e6', midColor: '#00d9ff', hotColor: '#ffeb8c' },
     constellation: { type: 'constellation', enabled: true, intensity: 1, speed: 0.3, color: '#ffe066', opacity: 0.9, starCount: 60, connectRadius: 1.2, orbitRadius: 2.0, twinkleSpeed: 2, lineOpacity: 0.3, starSize: 0.05 },
     hologram: { type: 'hologram', enabled: true, intensity: 1, speed: 1, color: '#00ffcc', opacity: 0.5, scanlineCount: 8, scanSpeed: 1.5, scanColor: '#00ffcc', gridEnabled: true, flickerAmount: 0.15, glitchEnabled: true },
-    portal: { type: 'portal', enabled: true, intensity: 1, speed: 1, color: '#8800ff', opacity: 0.85, radius: 1.5, spiralTurns: 6, innerGlowColor: '#ffffff', outerGlowColor: '#8800ff', rotationSpeed: 1.2, particleRingEnabled: true, particleCount: 80 },
+    portal: { type: 'portal', enabled: true, intensity: 1, speed: 1, color: '#8800ff', opacity: 0.95, radius: 1.5, spiralTurns: 6, innerGlowColor: '#e9e4ff', outerGlowColor: '#8800ff', rotationSpeed: 1.2, particleRingEnabled: true, particleCount: 160, throatSize: 0.38, funnelDepth: 0.6, otherSideColor: '#2a6bff' },
     dnaHelix: { type: 'dnaHelix', enabled: true, intensity: 0.02, speed: 1, color: '#ff6600', opacity: 0.9, particleCount: 60, strandCount: 2, helixRadius: 0.8, helixHeight: 2.0, basePairColor: '#aaffcc', runningLightEnabled: true },
     orb: { type: 'orb', enabled: true, intensity: 1.5, speed: 1, color: '#7b2fff', opacity: 0.9, coreSize: 0.15, glowLayers: 3, innerColor: '#ffffff', outerColor: '#7b2fff', coronaEnabled: true, coronaColor: '#88ccff', noiseAmount: 0.45, pulseSpeed: 1.5 },
     lightning: { type: 'lightning', enabled: true, intensity: 1, speed: 1, color: '#ffffff', opacity: 0.9, glowColor: '#6699ff', boltCount: 4, branchDepth: 4, branchProbability: 0.5, flickerRate: 10, strikeRadius: 2.0 },
@@ -16,16 +16,28 @@ export const DEFAULT_GENERATIVE_EFFECTS = {
     fire: { type: 'fire', enabled: true, intensity: 1, speed: 1, color: '#ff3300', opacity: 0.9, radius: 1.0, height: 2.0, radiusScale: 0.5, heightScale: 1.5, turbulence: 1.5, sway: 1.2, tint: '#ff6600', light: true, mode: 'tongues', coverage: 0.85, tongues: 36 },
     forcefield: { type: 'forcefield', enabled: true, intensity: 1, speed: 1, color: '#44aaff', opacity: 0.9, hexSize: 0.06, rippleEnabled: true, shieldColor: '#44aaff', rimColor: '#ffffff' },
     neuralNetwork: { type: 'neuralNetwork', enabled: true, intensity: 1, speed: 1, color: '#00aaff', opacity: 0.9, nodeCount: 20, signalSpeed: 1.2, nodeColor: '#00aaff', pulseColor: '#ffffff', orbitSpeed: 0.3 },
-    blackHole: { type: 'blackHole', enabled: true, intensity: 1.5, speed: 1, color: '#ff6600', opacity: 0.95, diskColor: '#ff6600', jetEnabled: true, jetColor: '#88aaff', rotationSpeed: 1.0, tilt: 15 },
-    iceCrystals: { type: 'iceCrystals', enabled: true, intensity: 1, speed: 0.5, color: '#88ccff', opacity: 0.9, spikeCount: 30, spikeLength: 1.0, frostEnabled: true, iceColor: '#88ccff', pulseSpeed: 0.4 },
-    smokePlume: { type: 'smokePlume', enabled: true, intensity: 1, speed: 1, color: '#aaaaaa', opacity: 0.6, particleCount: 180, height: 2.0, spread: 0.5, smokeColor: '#aaaaaa', turbulence: 0.5 },
-    volumetricFog: { type: 'volumetricFog', enabled: true, intensity: 1, speed: 0.4, color: '#cccccc', opacity: 0.5, particleCount: 60, fogRadius: 1.4, driftSpeed: 0.3, fogColor: '#cccccc', density: 0.35 },
-    smokeRing: { type: 'smokeRing', enabled: true, intensity: 1, speed: 1, color: '#bbbbbb', opacity: 0.65, ringCount: 2, expansionRadius: 3.0, riseSpeed: 0.5, intervalSeconds: 2.5, smokeColor: '#bbbbbb', thickness: 0.18 },
+    blackHole: { type: 'blackHole', enabled: true, intensity: 1.2, speed: 1, color: '#ffd2a0', opacity: 0.95, diskColor: '#ff6600', jetEnabled: true, jetColor: '#88aaff', rotationSpeed: 1, tilt: 15, horizonSize: 0.4, diskOuter: 3, lensing: 1, beaming: 1 },
+    iceCrystals: { type: 'iceCrystals', enabled: true, intensity: 1, speed: 0.5, color: '#88ccff', opacity: 0.9, spikeCount: 30, spikeLength: 1, frostEnabled: true, iceColor: '#9fd8ff', pulseSpeed: 0.4, habit: 0.8, branches: 5, sparkle: 1 },
+    smokePlume: { type: 'smokePlume', enabled: true, intensity: 1, speed: 1, color: '#aaaaaa', opacity: 0.6, particleCount: 180, height: 2, spread: 0.5, smokeColor: '#b4b4b8', turbulence: 0.5, heat: 0, wind: 0 },
+    volumetricFog: { type: 'volumetricFog', enabled: true, intensity: 1, speed: 0.4, color: '#fff1dc', opacity: 0.9, particleCount: 60, fogRadius: 1.8, driftSpeed: 0.3, fogColor: '#c9d2dc', density: 1, layerHeight: 1.2, anisotropy: 0.55, noiseScale: 1.5 },
+    smokeRing: { type: 'smokeRing', enabled: true, intensity: 1, speed: 1, color: '#bbbbbb', opacity: 0.65, ringCount: 2, expansionRadius: 3, riseSpeed: 0.5, intervalSeconds: 2.5, smokeColor: '#c4c4c8', thickness: 0.18, leapfrog: true, wobble: 0.5 },
     smokeRibbon: { type: 'smokeRibbon', enabled: true, intensity: 1, speed: 1, color: '#bbbbbb', detail: 1.4, remapLow: 0.2, remapHigh: 0.8, edgeX: 0.1, edgeY: 0.1, density: 1.0, twistStrength: 0.5, twistSpeed: 1.0, twistScale: 1.0, twistStart: 0.2 },
     flares: { type: 'flares', enabled: true, intensity: 1, speed: 1, color: '#ff6600', opacity: 0.9, shooting: true, maskResolution: 512, maskLayer: 0, radius: 1.0, padding: 0.5, fitKey: 'scale' },
     sparklesBurst: { type: 'sparklesBurst', enabled: true, intensity: 1, speed: 1, color: '#ffffff', opacity: 0.9, coreColor: '#ffffff', burstColor: '#ffffff', loop: true, durationMs: 1000, rayCount: 20, scale: 1.2, hoverColor: '#ffeb99', hoverRadius: 0.5, hoverIntensity: 2 },
     bubbles: { type: 'bubbles', enabled: true, intensity: 1, speed: 1, color: '#00ffff', opacity: 0.8, colors: ['#00ffff', '#88ccff', '#ffffff'], scale: 1.0, spawnRate: 5, floatSpeed: 0.5, iridescence: 0.7, lifetimeMs: 4000 },
     glyphs: { type: 'glyphs', enabled: true, intensity: 1, speed: 1, color: '#ff00ff', opacity: 0.9, ringColor: '#ff00ff', glyphsColor: '#ff00ff', shadesMultiplier: 0.5, hoverColor: '#ffeb99', hoverRadius: 0.5, hoverIntensity: 2, ringRadius: 1.2, glyphCount: 30, rotationSpeed: 0.5, morphSpeed: 0.3 },
+    fieldLines: { type: 'fieldLines', enabled: true, intensity: 1, speed: 1, color: '#7ff5e4', opacity: 0.9, shells: 4, linesPerShell: 12, extent: 3.2, twist: 0, tilt: 11, particleCount: 6, particleSize: 1.2, apexColor: '#6a5cff' },
+    strangeAttractor: { type: 'strangeAttractor', enabled: true, intensity: 1, speed: 1, color: '#5fb8ff', opacity: 0.9, system: 0, strands: 6, chaos: 0.5, trailLength: 0.18, scale: 1.4, ghostOpacity: 0.07, particleSize: 2.5, headColor: '#fff1c9' },
+    harmonicShell: { type: 'harmonicShell', enabled: true, intensity: 1, speed: 1, color: '#3a2a6b', opacity: 0.9, degree: 3, amplitude: 0.22, sizeMultiplier: 1.35, filmThickness: 380, nodalLines: 0.6, rimColor: '#bfe8ff' },
+    galaxy: { type: 'galaxy', enabled: true, intensity: 1, speed: 1, color: '#9fc4ff', opacity: 0.9, starCount: 18000, radius: 3, armTwist: 5.5, ellipticity: 0.32, bulgeSize: 0.22, dust: 0.6, tilt: 22, coreColor: '#ffd9a8' },
+    fireflySwarm: { type: 'fireflySwarm', enabled: true, intensity: 1, speed: 1, color: '#6f7d45', opacity: 1, count: 150, coupling: 1, frequency: 0.55, spread: 2.4, driftSpeed: 1, glowSize: 1, flashColor: '#d4ff5c' },
+    murmuration: { type: 'murmuration', enabled: true, intensity: 1, speed: 1, color: '#b9c8dc', opacity: 0.92, count: 2200, flockRadius: 2.6, cohesion: 1, alignment: 1, separation: 1, birdSize: 1 },
+    planetaryRings: { type: 'planetaryRings', enabled: true, intensity: 1, speed: 1, color: '#e9dcc2', opacity: 1, innerRadius: 1.35, outerRadius: 2.6, tilt: 17, moons: 3, spokes: 0.45, forwardScatter: 0.35, sunAngle: 45, sunElevation: 24, gapColor: '#8fa2b6', dustColor: '#ffd3a1' },
+    waterCaustics: { type: 'waterCaustics', enabled: true, intensity: 1, speed: 1, color: '#a9ecff', opacity: 1, waterDepth: 2.6, waveScale: 0.45, waveHeight: 1, dispersion: 0.5, radius: 3.4, showOnHost: true },
+    iceHalo: { type: 'iceHalo', enabled: true, intensity: 1, speed: 1, color: '#fff2dd', opacity: 1, haloScale: 0.35, sunDogs: 0.8, outerHalo: 0.4, parhelicCircle: 0.35, pillar: 0.45, glare: 0.9 },
+    fallingLeaves: { type: 'fallingLeaves', enabled: true, intensity: 1, speed: 1, color: '#7f9b3f', opacity: 1, leafCount: 60, leafSize: 1.3, fallHeight: 3, spread: 2.2, tumble: 0.35, wind: 0.5, autumnColor: '#c4631f' },
+    lichtenberg: { type: 'lichtenberg', enabled: true, intensity: 1, speed: 1, color: '#6f9dff', opacity: 1, nodeCount: 3200, branching: 2.2, growthTime: 9, lineWidth: 1, pulse: 0.6, coreColor: '#f2f6ff' },
+    dandelionSeeds: { type: 'dandelionSeeds', enabled: true, intensity: 1, speed: 1, color: '#ffeccf', opacity: 1, seedCount: 90, windSpeed: 0.55, windDirection: 20, turbulence: 0.8, seedSize: 1, lift: 1, stemColor: '#d8b183' },
 };
 export const GENERATIVE_EFFECT_LABELS = {
     molecules: 'Molecules',
@@ -52,4 +64,16 @@ export const GENERATIVE_EFFECT_LABELS = {
     sparklesBurst: 'Sparkles Burst',
     bubbles: 'Bubbles',
     glyphs: 'Glyphs',
+    fieldLines: 'Field Lines',
+    strangeAttractor: 'Strange Attractor',
+    harmonicShell: 'Harmonic Shell',
+    galaxy: 'Galaxy',
+    fireflySwarm: 'Firefly Swarm',
+    murmuration: 'Murmuration',
+    planetaryRings: 'Planetary Rings',
+    waterCaustics: 'Water Caustics',
+    iceHalo: 'Ice Halo',
+    fallingLeaves: 'Falling Leaves',
+    lichtenberg: 'Lichtenberg',
+    dandelionSeeds: 'Dandelion Seeds',
 };

package/dist/shaders/ChladniGridMaterial.d.ts

@@ -0,0 +1,77 @@
+import * as THREE from 'three';
+/**
+ * Chladni plates: the nodal lines of a standing wave on a square plate, with sand settling on them, drifting slowly between two neighbouring resonances.
+ *
+ * Shares the grid vocabulary with the other shader-plane grids (lineMode /
+ * cellMode 0..4, fade, reveal, focus), so the same controller drives it.
+ */
+export interface ChladniGridMaterialUniforms {
+    u_time: number;
+    u_cellSize: number;
+    u_lineWidth: number;
+    u_sectionSize: number;
+    u_sectionWidth: number;
+    u_lineColor: THREE.Color;
+    u_sectionColor: THREE.Color;
+    u_cellColor: THREE.Color;
+    u_glowColor: THREE.Color;
+    u_bgColor: THREE.Color;
+    u_bgOpacity: number;
+    u_lineMode: number;
+    u_cellMode: number;
+    u_animSpeed: number;
+    u_animScale: number;
+    u_animIntensity: number;
+    u_fadeDistance: number;
+    u_fadeStrength: number;
+    u_focus: THREE.Vector2;
+    u_mouse: THREE.Vector2;
+    u_displace: number;
+    /** 0..1 assemble/dissolve. The build boundary sweeps outward from u_focus with a bright leading edge; 1 is fully built, 0 is gone. */
+    u_reveal: number;
+    /** first mode number of the standing wave, 1..12 */
+    u_modeN: number;
+    /** second mode number of the standing wave, 1..12 */
+    u_modeM: number;
+    /** how fast the plate drifts to the neighbouring resonance; 0 holds the pattern */
+    u_morph: number;
+    /** 0..1 amount of sand on the plate */
+    u_grain: number;
+}
+declare module '@react-three/fiber' {
+    interface ThreeElements {
+        chladniGridMaterial: ThreeElements['shaderMaterial'] & Partial<ChladniGridMaterialUniforms>;
+    }
+}
+export declare const chladniGridMaterialDefaults: ChladniGridMaterialUniforms;
+export declare const ChladniGridMaterial: import("@react-three/fiber").ConstructorRepresentation<THREE.ShaderMaterial & {
+    u_time: number;
+    u_cellSize: number;
+    u_lineWidth: number;
+    u_sectionSize: number;
+    u_sectionWidth: number;
+    u_lineColor: THREE.Color;
+    u_sectionColor: THREE.Color;
+    u_cellColor: THREE.Color;
+    u_glowColor: THREE.Color;
+    u_bgColor: THREE.Color;
+    u_bgOpacity: number;
+    u_lineMode: number;
+    u_cellMode: number;
+    u_animSpeed: number;
+    u_animScale: number;
+    u_animIntensity: number;
+    u_fadeDistance: number;
+    u_fadeStrength: number;
+    u_focus: THREE.Vector2;
+    u_mouse: THREE.Vector2;
+    u_displace: number;
+    u_reveal: number;
+    u_modeN: number;
+    u_modeM: number;
+    u_morph: number;
+    u_grain: number;
+}> & {
+    key: string;
+};
+//# sourceMappingURL=ChladniGridMaterial.d.ts.map

package/dist/shaders/ChladniGridMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChladniGridMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/ChladniGridMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,aAAa;QACnB,mBAAmB,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;KAC/F;CACJ;AAED,eAAO,MAAM,2BAA2B,EAAE,2BA2BzC,CAAC;AAqPF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/B,CAAC"}

package/dist/shaders/ChladniGridMaterial.js

@@ -0,0 +1,301 @@
+import * as THREE from 'three';
+import { shaderMaterial } from '@react-three/drei';
+import { extend } from '@react-three/fiber';
+export const chladniGridMaterialDefaults = {
+    u_time: 0,
+    u_cellSize: 8,
+    u_lineWidth: 1.2,
+    u_sectionSize: 1,
+    u_sectionWidth: 0.8,
+    u_lineColor: new THREE.Color('#d9c7a3'),
+    u_sectionColor: new THREE.Color('#4d5d6e'),
+    u_cellColor: new THREE.Color('#16222e'),
+    u_glowColor: new THREE.Color('#ffe2a8'),
+    u_bgColor: new THREE.Color('#06080b'),
+    u_bgOpacity: 0,
+    u_lineMode: 0,
+    u_cellMode: 2,
+    u_animSpeed: 1,
+    u_animScale: 0.5,
+    u_animIntensity: 0.6,
+    u_fadeDistance: 25,
+    u_fadeStrength: 0.6,
+    u_focus: new THREE.Vector2(0, 0),
+    u_mouse: new THREE.Vector2(0, 0),
+    u_displace: 0,
+    u_reveal: 1.0,
+    u_modeN: 3,
+    u_modeM: 5,
+    u_morph: 0.4,
+    u_grain: 0.8,
+};
+const vertex = /* glsl */ `
+  
+  uniform float u_time;
+  uniform float u_cellSize;
+  uniform float u_displace;
+  uniform float u_animSpeed;
+  uniform float u_animScale;
+
+  varying vec2 vGridPos;
+
+  
+  const float PI  = 3.14159265359;
+  const float TAU = 6.28318530718;
+
+  float hash21(vec2 p){
+    p = fract(p * vec2(123.34, 456.21));
+    p += dot(p, p + 45.32);
+    return fract(p.x * p.y);
+  }
+
+  
+  uniform float u_modeN;
+  uniform float u_modeM;
+  uniform float u_morph;
+
+  // Chladni's plate. A standing wave on a square plate is a superposition of
+  // two degenerate modes, cos(n*pi*x)cos(m*pi*y) - cos(m*pi*x)cos(n*pi*y).
+  // Sand collects where it is zero: the nodal lines.
+  float chladniMode(vec2 x, float n, float m){
+    m += step(abs(n - m), 0.5);   // n == m is the trivial zero field
+    return cos(n * x.x) * cos(m * x.y) - cos(m * x.x) * cos(n * x.y);
+  }
+
+  float chladniField(vec2 coord, float t){
+    float n = floor(clamp(u_modeN, 1.0, 12.0) + 0.5);
+    float m = floor(clamp(u_modeM, 1.0, 12.0) + 0.5);
+    vec2 x = coord * PI;
+    // Drift between two neighbouring resonances: the nodal lines slide
+    // continuously from one pattern into the next.
+    float a = t * u_morph * 0.35;
+    return cos(a) * chladniMode(x, n, m) + sin(a) * chladniMode(x, n + 1.0, m);
+  }
+
+
+  void main(){
+    vGridPos = position.xy;
+    vec3 pos = position;
+    if (u_displace > 0.0){
+      // the plate itself vibrates: the displacement is the standing wave
+      float t = u_time * u_animSpeed;
+      float f = chladniField(position.xy / max(u_cellSize, 1e-4), t);
+      pos.z += f * u_displace * 0.5 * sin(t * 3.0);
+    }
+    gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
+  }
+`;
+const fragment = /* glsl */ `
+  
+  precision highp float;
+
+  uniform float u_time;
+  uniform float u_cellSize;
+  uniform float u_lineWidth;
+  uniform float u_sectionSize;
+  uniform float u_sectionWidth;
+  uniform vec3  u_lineColor;
+  uniform vec3  u_sectionColor;
+  uniform vec3  u_cellColor;
+  uniform vec3  u_glowColor;
+  uniform vec3  u_bgColor;
+  uniform float u_bgOpacity;
+  uniform float u_lineMode;
+  uniform float u_cellMode;
+  uniform float u_animSpeed;
+  uniform float u_animScale;
+  uniform float u_animIntensity;
+  uniform float u_fadeDistance;
+  uniform float u_fadeStrength;
+  uniform vec2  u_focus;
+  uniform float u_reveal;
+
+  varying vec2 vGridPos;
+
+  float lineAt(float c, float width, float fp){
+    float d = abs(fract(c - 0.5) - 0.5);
+    return 1.0 - clamp(d / max(fp * max(width, 0.05), 1e-6), 0.0, 1.0);
+  }
+
+  
+  const float PI  = 3.14159265359;
+  const float TAU = 6.28318530718;
+
+  float hash21(vec2 p){
+    p = fract(p * vec2(123.34, 456.21));
+    p += dot(p, p + 45.32);
+    return fract(p.x * p.y);
+  }
+
+  
+  uniform float u_modeN;
+  uniform float u_modeM;
+  uniform float u_morph;
+
+  // Chladni's plate. A standing wave on a square plate is a superposition of
+  // two degenerate modes, cos(n*pi*x)cos(m*pi*y) - cos(m*pi*x)cos(n*pi*y).
+  // Sand collects where it is zero: the nodal lines.
+  float chladniMode(vec2 x, float n, float m){
+    m += step(abs(n - m), 0.5);   // n == m is the trivial zero field
+    return cos(n * x.x) * cos(m * x.y) - cos(m * x.x) * cos(n * x.y);
+  }
+
+  float chladniField(vec2 coord, float t){
+    float n = floor(clamp(u_modeN, 1.0, 12.0) + 0.5);
+    float m = floor(clamp(u_modeM, 1.0, 12.0) + 0.5);
+    vec2 x = coord * PI;
+    // Drift between two neighbouring resonances: the nodal lines slide
+    // continuously from one pattern into the next.
+    float a = t * u_morph * 0.35;
+    return cos(a) * chladniMode(x, n, m) + sin(a) * chladniMode(x, n + 1.0, m);
+  }
+
+
+  uniform float u_grain;
+
+  void main(){
+    float cs = max(u_cellSize, 1e-4);
+    vec2 coord = vGridPos / cs;           // one plate per cell
+    vec2 focus = u_focus / cs;
+    float t = u_time * u_animSpeed;
+
+    float f  = chladniField(coord, t);
+    float fp = max(fwidth(f), 1e-5);
+    float nodal = 1.0 - clamp(abs(f) / (fp * max(u_lineWidth, 0.05)), 0.0, 1.0);
+
+    // Sand: one grain slot per small cell. A grain sits in its slot with a
+    // probability that falls off exponentially with the local amplitude |f|,
+    // so grains pile up on the nodal lines and thin out towards antinodes.
+    vec2  gq  = coord * 72.0;
+    vec2  gid = floor(gq);
+    float gh  = hash21(gid);
+    vec2  go  = vec2(hash21(gid + 3.1), hash21(gid + 7.7)) - 0.5;
+    float gd  = length(fract(gq) - 0.5 - go * 0.4);
+    float gpx = 1.0 / max(length(fwidth(gq)) * 0.7071, 1e-4);   // pixels per slot
+    float settle  = exp(-abs(f) * 7.0);
+    float grainOn = step(gh, u_grain * settle);
+    float disk = 1.0 - smoothstep(0.22 - 0.5 / gpx, 0.22 + 0.5 / gpx, gd);
+    // when a slot is smaller than a couple of pixels, draw the average density instead
+    float resolved = clamp((gpx - 1.5) / 3.0, 0.0, 1.0);
+    float sand = mix(u_grain * settle * 0.35,
+                     grainOn * disk * (0.55 + 0.45 * hash21(gid + 1.3)),
+                     resolved);
+
+    float lines = max(nodal, sand);
+
+    float accent = 0.0;
+    if (u_sectionWidth > 0.0 && u_sectionSize > 0.0){
+      vec2 sc  = coord / u_sectionSize;
+      vec2 sfp = max(fwidth(sc), vec2(1e-6));
+      accent = max(lineAt(sc.x, u_sectionWidth, sfp.x), lineAt(sc.y, u_sectionWidth, sfp.y));
+    }
+
+    vec2  plate = floor(coord);
+    float cellH = hash21(plate + 0.5);
+    float cellDist  = length(coord - focus) * 6.0;
+    float flowCoord = (coord.x + coord.y) * 6.0;
+    float scanCoord = (coord.x + coord.y) * 8.0;
+    // the fill shimmers on the antinodes and stays off the sand
+    float edgeKeep = smoothstep(0.15, 0.9, abs(f));
+    float fadeR = length(vGridPos) / max(u_fadeDistance, 1e-4);
+
+    vec3  extraCol = u_glowColor * nodal * 0.25;
+    float extraA = 0.0;
+    float regionMask = 1.0;
+
+    // ---- line animation --------------------------------------------------
+    float lineAnim = 1.0;
+    if (u_lineMode > 0.5){
+      if (u_lineMode < 1.5){
+        lineAnim = 0.5 + 0.5 * sin(cellDist * u_animScale - t);
+      } else if (u_lineMode < 2.5){
+        lineAnim = 0.5 + 0.5 * sin(flowCoord * u_animScale - t);
+      } else if (u_lineMode < 3.5){
+        float s = fract(scanCoord * 0.05 * u_animScale - t * 0.15);
+        lineAnim = 0.25 + smoothstep(0.0, 0.15, s) * (1.0 - smoothstep(0.15, 0.35, s));
+      } else {
+        lineAnim = 0.5 + 0.5 * sin(t);
+      }
+    }
+    lineAnim = mix(1.0, lineAnim, u_animIntensity);
+
+    // ---- cell fill -------------------------------------------------------
+    float cell = 0.0;
+    if (u_cellMode > 0.5){
+      if (u_cellMode < 1.5){
+        cell = 0.5 + 0.5 * sin(flowCoord * 0.5 * u_animScale - t);
+      } else if (u_cellMode < 2.5){
+        cell = 0.5 + 0.5 * sin(t * (0.6 + cellH) + cellH * TAU);
+      } else if (u_cellMode < 3.5){
+        cell = smoothstep(0.6, 1.0, sin(cellDist * u_animScale - t));
+      } else {
+        cell = step(0.5, cellH) * (0.5 + 0.5 * sin(t));
+      }
+    }
+    cell *= u_animIntensity * edgeKeep;
+
+    float tone = step(0.55, cellH);
+
+    vec3 col = u_bgColor * u_bgOpacity;
+    float a  = u_bgOpacity;
+
+    col += mix(u_cellColor, u_cellColor * 2.2, tone) * cell;
+    a = max(a, cell * 0.9);
+    float linesI = lines * lineAnim;
+    col += u_lineColor * linesI;            a = max(a, linesI);
+    float accentI = accent * lineAnim;
+    col += u_sectionColor * accentI;        a = max(a, accentI);
+    col += u_glowColor * (linesI * 0.2 + cell * 0.35) * u_animIntensity;
+
+    col = col * regionMask + extraCol;
+    a   = max(a * regionMask, extraA);
+
+    float fade = 1.0 - smoothstep(1.0 - u_fadeStrength, 1.0, fadeR);
+    col *= fade;
+    a   *= fade;
+
+    // ---- reveal ----------------------------------------------------------
+    // The build boundary sweeps outward from the focus point with a bright
+    // leading edge, so the grid reads as assembling itself.
+    if (u_reveal < 0.999){
+      float rd = length(vGridPos - u_focus) / max(u_fadeDistance, 1e-4);
+      float edge = u_reveal * 1.1;
+      float mask = 1.0 - smoothstep(edge - 0.05, edge, rd);
+      float front = mask * smoothstep(edge - 0.22, edge - 0.05, rd);
+      col = col * mask + u_glowColor * front * (a * 1.8 + 0.08);
+      a   = max(a * mask, front * 0.10);
+    }
+
+    if (a < 0.002) discard;
+    gl_FragColor = vec4(col, a);
+  }
+`;
+export const ChladniGridMaterial = shaderMaterial({
+    u_time: chladniGridMaterialDefaults.u_time,
+    u_cellSize: chladniGridMaterialDefaults.u_cellSize,
+    u_lineWidth: chladniGridMaterialDefaults.u_lineWidth,
+    u_sectionSize: chladniGridMaterialDefaults.u_sectionSize,
+    u_sectionWidth: chladniGridMaterialDefaults.u_sectionWidth,
+    u_lineColor: chladniGridMaterialDefaults.u_lineColor.clone(),
+    u_sectionColor: chladniGridMaterialDefaults.u_sectionColor.clone(),
+    u_cellColor: chladniGridMaterialDefaults.u_cellColor.clone(),
+    u_glowColor: chladniGridMaterialDefaults.u_glowColor.clone(),
+    u_bgColor: chladniGridMaterialDefaults.u_bgColor.clone(),
+    u_bgOpacity: chladniGridMaterialDefaults.u_bgOpacity,
+    u_lineMode: chladniGridMaterialDefaults.u_lineMode,
+    u_cellMode: chladniGridMaterialDefaults.u_cellMode,
+    u_animSpeed: chladniGridMaterialDefaults.u_animSpeed,
+    u_animScale: chladniGridMaterialDefaults.u_animScale,
+    u_animIntensity: chladniGridMaterialDefaults.u_animIntensity,
+    u_fadeDistance: chladniGridMaterialDefaults.u_fadeDistance,
+    u_fadeStrength: chladniGridMaterialDefaults.u_fadeStrength,
+    u_focus: chladniGridMaterialDefaults.u_focus.clone(),
+    u_mouse: chladniGridMaterialDefaults.u_mouse.clone(),
+    u_displace: chladniGridMaterialDefaults.u_displace,
+    u_reveal: chladniGridMaterialDefaults.u_reveal,
+    u_modeN: chladniGridMaterialDefaults.u_modeN,
+    u_modeM: chladniGridMaterialDefaults.u_modeM,
+    u_morph: chladniGridMaterialDefaults.u_morph,
+    u_grain: chladniGridMaterialDefaults.u_grain,
+}, vertex, fragment);
+extend({ ChladniGridMaterial });

package/dist/shaders/FlowNetGridMaterial.d.ts

@@ -0,0 +1,74 @@
+import * as THREE from 'three';
+/**
+ * Potential flow past a cylinder with circulation, drawn as a flow net: streamlines and equipotentials that cross at right angles everywhere and bend around the obstacle.
+ *
+ * Shares the grid vocabulary with the other shader-plane grids (lineMode /
+ * cellMode 0..4, fade, reveal, focus), so the same controller drives it.
+ */
+export interface FlowNetGridMaterialUniforms {
+    u_time: number;
+    u_cellSize: number;
+    u_lineWidth: number;
+    u_sectionSize: number;
+    u_sectionWidth: number;
+    u_lineColor: THREE.Color;
+    u_sectionColor: THREE.Color;
+    u_cellColor: THREE.Color;
+    u_glowColor: THREE.Color;
+    u_bgColor: THREE.Color;
+    u_bgOpacity: number;
+    u_lineMode: number;
+    u_cellMode: number;
+    u_animSpeed: number;
+    u_animScale: number;
+    u_animIntensity: number;
+    u_fadeDistance: number;
+    u_fadeStrength: number;
+    u_focus: THREE.Vector2;
+    u_mouse: THREE.Vector2;
+    u_displace: number;
+    /** 0..1 assemble/dissolve. The build boundary sweeps outward from u_focus with a bright leading edge; 1 is fully built, 0 is gone. */
+    u_reveal: number;
+    /** cylinder radius, in cells */
+    u_obstacleRadius: number;
+    /** circulation around the cylinder, in whole units; shifts the flow to one side (lift) */
+    u_circulation: number;
+    /** direction of the free-stream flow, in radians */
+    u_flowAngle: number;
+}
+declare module '@react-three/fiber' {
+    interface ThreeElements {
+        flowNetGridMaterial: ThreeElements['shaderMaterial'] & Partial<FlowNetGridMaterialUniforms>;
+    }
+}
+export declare const flowNetGridMaterialDefaults: FlowNetGridMaterialUniforms;
+export declare const FlowNetGridMaterial: import("@react-three/fiber").ConstructorRepresentation<THREE.ShaderMaterial & {
+    u_time: number;
+    u_cellSize: number;
+    u_lineWidth: number;
+    u_sectionSize: number;
+    u_sectionWidth: number;
+    u_lineColor: THREE.Color;
+    u_sectionColor: THREE.Color;
+    u_cellColor: THREE.Color;
+    u_glowColor: THREE.Color;
+    u_bgColor: THREE.Color;
+    u_bgOpacity: number;
+    u_lineMode: number;
+    u_cellMode: number;
+    u_animSpeed: number;
+    u_animScale: number;
+    u_animIntensity: number;
+    u_fadeDistance: number;
+    u_fadeStrength: number;
+    u_focus: THREE.Vector2;
+    u_mouse: THREE.Vector2;
+    u_displace: number;
+    u_reveal: number;
+    u_obstacleRadius: number;
+    u_circulation: number;
+    u_flowAngle: number;
+}> & {
+    key: string;
+};
+//# sourceMappingURL=FlowNetGridMaterial.d.ts.map

package/dist/shaders/FlowNetGridMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowNetGridMaterial.d.ts","sourceRoot":"","sources":["../../src/shaders/FlowNetGridMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,aAAa;QACnB,mBAAmB,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;KAC/F;CACJ;AAED,eAAO,MAAM,2BAA2B,EAAE,2BA0BzC,CAAC;AAuNF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B/B,CAAC"}