@3driseai/3drise-core 1.0.18 → 1.0.20

package/dist/data/gridsDefaults.js

@@ -0,0 +1,290 @@
+// =============================================================================
+// GRIDS_ANIMATABLE — which grid config knobs an animation or pointer may drive
+// =============================================================================
+//
+// Keyed by the grid's config.type (quasiGrid, gravWaveGrid, ...). A grid is listed
+// only once its component feeds the material from a merged config (committed +
+// live + keyframe + pointer) through one push point, and only with the knobs that
+// push point applies (applyGridConfig in the viewer: the shared surface knobs
+// plus the grid's own). Structural knobs, mode selects and whole-number counts
+// (size, displace, lineMode, cellMode, sectionSize, tiling, group, levels,
+// tileCells) are never listed.
+//
+// Lives in core rather than beside the grid configs in the viewer, because the
+// registry in utils/generativeAnimatable.ts (read by the animations and pointer
+// panels) is core's, and core cannot import from the viewer.
+//
+export const GRIDS_ANIMATABLE = {
+    gravWaveGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'strain', label: 'Strain' },
+        { value: 'chirpTime', label: 'Chirp Time' },
+        { value: 'waveSpeed', label: 'Wave Speed' },
+        { value: 'massRatio', label: 'Mass Ratio' },
+    ],
+    girihGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'contactAngle', label: 'Contact Angle' },
+        { value: 'strapWidth', label: 'Strap Width' },
+        { value: 'angleDrift', label: 'Angle Drift' },
+    ],
+    wallpaperGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'cycleTime', label: 'Cycle Time' },
+        { value: 'motif', label: 'Motif' },
+    ],
+    reactionDiffusionGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'feed', label: 'Feed' },
+        { value: 'kill', label: 'Kill' },
+        { value: 'variation', label: 'Variation' },
+    ],
+    quasiGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'phase', label: 'Phase' },
+    ],
+    hexGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+    ],
+    circuitGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'powered', label: 'Powered' },
+        { value: 'chipChance', label: 'Chip Chance' },
+        { value: 'padSize', label: 'Pad Size' },
+    ],
+    voronoiGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'jitter', label: 'Jitter' },
+        { value: 'drift', label: 'Drift' },
+    ],
+    radarGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'sweepWidth', label: 'Sweep Width' },
+        { value: 'blipDensity', label: 'Blip Density' },
+    ],
+    moireGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'layerAngle', label: 'Layer Angle' },
+        { value: 'layerScale', label: 'Layer Scale' },
+        { value: 'spin', label: 'Spin' },
+    ],
+    fractalGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'splitRadius', label: 'Split Radius' },
+        { value: 'splitJitter', label: 'Split Jitter' },
+    ],
+    contourGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'warp', label: 'Warp' },
+    ],
+    flowNetGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'obstacleRadius', label: 'Obstacle Radius' },
+        { value: 'flowAngle', label: 'Flow Angle' },
+    ],
+    chladniGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'morph', label: 'Morph' },
+        { value: 'grain', label: 'Grain' },
+    ],
+    hyperbolicGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+        { value: 'drift', label: 'Drift' },
+    ],
+    advancedGrid: [
+        { value: 'cellSize', label: 'Cell Size' },
+        { value: 'lineWidth', label: 'Line Width' },
+        { value: 'sectionWidth', label: 'Section Width' },
+        { value: 'animSpeed', label: 'Anim Speed' },
+        { value: 'animScale', label: 'Anim Scale' },
+        { value: 'animIntensity', label: 'Anim Intensity' },
+        { value: 'fadeStrength', label: 'Fade Strength' },
+        { value: 'bgOpacity', label: 'Bg Opacity' },
+        { value: 'lineColor', label: 'Line Color' },
+        { value: 'sectionColor', label: 'Section Color' },
+        { value: 'cellColor', label: 'Cell Color' },
+        { value: 'glowColor', label: 'Glow Color' },
+        { value: 'bgColor', label: 'Bg Color' },
+    ],
+};

package/dist/data/index.d.ts

@@ -6,6 +6,7 @@ export * from './paths';
 export * from './effectsDefaults';
 export * from './particlesDefaults';
 export * from './lightsDefaults';
+export * from './gridsDefaults';
 export * from './shadowDefaults';
 export * from './defaults';
 export * from './shaders';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/data/index.js

@@ -6,6 +6,7 @@ export * from './paths.js';
 export * from './effectsDefaults.js';
 export * from './particlesDefaults.js';
 export * from './lightsDefaults.js';
+export * from './gridsDefaults.js';
 export * from './shadowDefaults.js';
 export * from './defaults.js';
 export * from './shaders.js';

package/dist/data/particlesDefaults.d.ts

@@ -1,4 +1,4 @@
-import type { GenerativeParticlesConfig, GenerativeParticlesType } from "../types";
+import type { GenerativeParticlesConfig, GenerativeParticlesType, ParticleShapeConfig, ParticleShapeType } from "../types";
 export declare const DEFAULT_GENERATIVE_PARTICLES: Record<GenerativeParticlesType, GenerativeParticlesConfig>;
 export declare const GENERATIVE_PARTICLES_LABELS: Record<GenerativeParticlesType, string>;
 /** Knobs the animation / mouse-move systems may drive per frame (see GENERATIVE_ANIMATABLE). */
@@ -6,6 +6,8 @@ export declare const GENERATIVE_PARTICLES_ANIMATABLE: Record<GenerativeParticles
     value: string;
     label: string;
 }[]>;
+export declare const PARTICLE_SHAPE_TYPES: readonly ParticleShapeType[];
+export declare const PARTICLE_SHAPE_DEFAULTS: Record<ParticleShapeType, ParticleShapeConfig>;
 /** True when a particles object's config is a generative particle object (not the legacy shape particles). */
 export declare function isGenerativeParticlesConfig(config: unknown): config is GenerativeParticlesConfig;
 //# sourceMappingURL=particlesDefaults.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"particlesDefaults.d.ts","sourceRoot":"","sources":["../../src/data/particlesDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAKnF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,uBAAuB,EAAE,yBAAyB,CASnG,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAS/E,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,uBAAuB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CA6J/G,CAAC;AAEF,8GAA8G;AAC9G,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,yBAAyB,CAGhG"}
+{"version":3,"file":"particlesDefaults.d.ts","sourceRoot":"","sources":["../../src/data/particlesDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK3H,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,uBAAuB,EAAE,yBAAyB,CAYnG,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAY/E,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,uBAAuB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAoN/G,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAA0H,CAAC;AAExL,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAWlF,CAAC;AAEF,8GAA8G;AAC9G,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,yBAAyB,CAGhG"}

package/dist/data/particlesDefaults.js

@@ -10,6 +10,9 @@ export const DEFAULT_GENERATIVE_PARTICLES = {
     chladniSand: { type: 'chladniSand', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#f1e3c2', particleCount: 20000, frequency: 4.63, sweep: 0.4, damping: 0.025, amplitude: 1, hopColor: '#fff3d6', lightAngle: 22, grainSize: 1, seed: 1, quality: 'medium', pointerMode: 'bow', pointerStrength: 1, pointerRadius: 1, pointerColor: '#fff4dc', trailMode: 'streak', trailLength: 1.6, trailOpacity: 0.6, trailColor: '#ffcf8a', trailShare: 0.5 },
     faradayPowder: { type: 'faradayPowder', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#ff8a2a', particleCount: 12000, frequency: 4.63, sweep: 0.3, damping: 0.025, amplitude: 1, glowColor: '#ffe7a6', hover: 1, swirl: 1, puffSize: 1, seed: 1, quality: 'medium', pointerMode: 'bow', pointerStrength: 1, pointerRadius: 1, pointerColor: '#fff4dc', trailMode: 'comet', trailLength: 1.6, trailOpacity: 0.6, trailColor: '#ff5a1e', trailShare: 0.6 },
     neonRain: { type: 'neonRain', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#ff2f9a', particleCount: 10000, rainRate: 18, windSpeed: 0.8, gustiness: 0.6, neonColor2: '#22dcff', lampColor: '#ffae52', neonLight: 1, aperture: 0.5, dropSize: 1, seed: 1, quality: 'medium', pointerMode: 'umbrella', pointerStrength: 1, pointerRadius: 1, pointerColor: '#eaf2ff', trailMode: 'streak', trailLength: 1.2, trailOpacity: 0.7, trailColor: '#9fb8ff', trailShare: 0.6 },
+    magneticBottle: { type: 'magneticBottle', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#5fd6ff', particleCount: 48, shape: { type: 'cone', radius: 0.5, height: 1, radialSegments: 32 }, windings: 0.6, pitchSpread: 0.3, lineLife: 6, lineDensity: 1, counterColor: '#ff6fb3', glow: 1, seed: 1, quality: 'medium', pointerMode: 'drift', pointerStrength: 1, pointerRadius: 1, pointerColor: '#fff0c8', trailMode: 'comet', trailLength: 0.8, trailOpacity: 0.8, trailColor: '#8f7bff', trailShare: 1 },
+    shapeBurst: { type: 'shapeBurst', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#45d1ff', particleCount: 180, shape: { type: 'icosahedron', radius: 0.5, detail: 0 }, interval: 2.8, formSpeed: 2.4, fieldStrength: 1, holdTime: 1.2, dissolve: 0.3, counterColor: '#ff5aa8', heatColor: '#fff6e0', headSize: 1.4, seed: 1, quality: 'medium', pointerMode: 'detonate', pointerStrength: 1, pointerRadius: 1, pointerColor: '#ffffff', trailMode: 'comet', trailLength: 0.4, trailOpacity: 0.8, trailColor: '#6a5cff', trailShare: 0.5 },
+    shapeFlow: { type: 'shapeFlow', enabled: true, intensity: 1, speed: 1, opacity: 0.9, size: 1, color: '#3f7bff', particleCount: 2400, shape: { type: 'sphere', radius: 0.5, segments: 32, rings: 32 }, flowSpeed: 1, windPitch: 0, rake: 'sheet', lanes: 44, streamWidth: 0.85, turbulence: 0.9, fastColor: '#ff6a3d', headSize: 1, seed: 1, quality: 'medium', pointerMode: 'obstacle', pointerStrength: 1, pointerRadius: 1, pointerColor: '#ffffff', trailMode: 'comet', trailLength: 1.2, trailOpacity: 0.7, trailColor: '#1b2a6b', trailShare: 1 },
 };
 export const GENERATIVE_PARTICLES_LABELS = {
     tidalStream: 'Tidal Stream',
@@ -20,6 +23,9 @@ export const GENERATIVE_PARTICLES_LABELS = {
     chladniSand: 'Chladni Sand',
     faradayPowder: 'Faraday Powder',
     neonRain: 'Neon Rain',
+    magneticBottle: 'Magnetic Bottle',
+    shapeBurst: 'Shape Burst',
+    shapeFlow: 'Shape Flow',
 };
 /** Knobs the animation / mouse-move systems may drive per frame (see GENERATIVE_ANIMATABLE). */
 export const GENERATIVE_PARTICLES_ANIMATABLE = {
@@ -179,6 +185,78 @@ export const GENERATIVE_PARTICLES_ANIMATABLE = {
         { value: 'trailOpacity', label: 'Trail Opacity' },
         { value: 'trailColor', label: 'Trail Color' },
     ],
+    magneticBottle: [
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'speed', label: 'Speed' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'color', label: 'Color' },
+        { value: 'windings', label: 'Windings' },
+        { value: 'pitchSpread', label: 'Pitch Spread' },
+        { value: 'lineLife', label: 'Line Life' },
+        { value: 'lineDensity', label: 'Line Density' },
+        { value: 'counterColor', label: 'Counter Color' },
+        { value: 'glow', label: 'Glow' },
+        { value: 'pointerStrength', label: 'Pointer Strength' },
+        { value: 'pointerRadius', label: 'Pointer Radius' },
+        { value: 'pointerColor', label: 'Pointer Color' },
+        { value: 'trailLength', label: 'Trail Length' },
+        { value: 'trailOpacity', label: 'Trail Opacity' },
+        { value: 'trailColor', label: 'Trail Color' },
+    ],
+    shapeBurst: [
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'speed', label: 'Speed' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'color', label: 'Color' },
+        { value: 'interval', label: 'Interval' },
+        { value: 'formSpeed', label: 'Form Speed' },
+        { value: 'fieldStrength', label: 'Field Strength' },
+        { value: 'holdTime', label: 'Hold Time' },
+        { value: 'dissolve', label: 'Dissolve' },
+        { value: 'counterColor', label: 'Counter Color' },
+        { value: 'heatColor', label: 'Heat Color' },
+        { value: 'headSize', label: 'Head Size' },
+        { value: 'pointerStrength', label: 'Pointer Strength' },
+        { value: 'pointerRadius', label: 'Pointer Radius' },
+        { value: 'pointerColor', label: 'Pointer Color' },
+        { value: 'trailLength', label: 'Trail Length' },
+        { value: 'trailOpacity', label: 'Trail Opacity' },
+        { value: 'trailColor', label: 'Trail Color' },
+    ],
+    shapeFlow: [
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'speed', label: 'Speed' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'color', label: 'Color' },
+        { value: 'flowSpeed', label: 'Flow Speed' },
+        { value: 'streamWidth', label: 'Stream Width' },
+        { value: 'turbulence', label: 'Turbulence' },
+        { value: 'fastColor', label: 'Fast Color' },
+        { value: 'headSize', label: 'Head Size' },
+        { value: 'pointerStrength', label: 'Pointer Strength' },
+        { value: 'pointerRadius', label: 'Pointer Radius' },
+        { value: 'pointerColor', label: 'Pointer Color' },
+        { value: 'trailLength', label: 'Trail Length' },
+        { value: 'trailOpacity', label: 'Trail Opacity' },
+        { value: 'trailColor', label: 'Trail Color' },
+    ],
+};
+// =============================================================================
+// PARTICLE SHAPES — the `shape` config of shape-driven particle objects (magneticBottle,
+// shapeBurst, shapeFlow). Defaults are the core mesh builders' own defaults.
+// =============================================================================
+export const PARTICLE_SHAPE_TYPES = ['cone', 'cylinder', 'sphere', 'capsule', 'torus', 'box', 'tetrahedron', 'octahedron', 'icosahedron', 'dodecahedron'];
+export const PARTICLE_SHAPE_DEFAULTS = {
+    cone: { type: 'cone', radius: 0.5, height: 1, radialSegments: 32 },
+    cylinder: { type: 'cylinder', radiusTop: 0.5, radiusBottom: 0.5, height: 1, radialSegments: 32 },
+    sphere: { type: 'sphere', radius: 0.5, segments: 32, rings: 32 },
+    capsule: { type: 'capsule', radius: 0.3, length: 1, capSegments: 4, radialSegments: 8 },
+    torus: { type: 'torus', radius: 0.5, tube: 0.2, radialSegments: 16, tubularSegments: 100 },
+    box: { type: 'box', size: [1, 1, 1] },
+    tetrahedron: { type: 'tetrahedron', radius: 0.5, detail: 0 },
+    octahedron: { type: 'octahedron', radius: 0.5, detail: 0 },
+    icosahedron: { type: 'icosahedron', radius: 0.5, detail: 0 },
+    dodecahedron: { type: 'dodecahedron', radius: 0.5, detail: 0 },
 };
 /** True when a particles object's config is a generative particle object (not the legacy shape particles). */
 export function isGenerativeParticlesConfig(config) {