@3driseai/3drise-viewer 0.1.28 → 0.1.30

package/dist/components/MoonDisc.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+import { useCloudSun } from '../hooks/useCloudSun.js';
+import { resolveMoon } from '../utils/skyMoon.js';
+/**
+ * The moon in the sky, for either sky renderer.
+ *
+ * A camera-facing quad placed toward the moon just inside the far plane, so the
+ * sky (drawn at the far plane) is behind it and terrain and objects occlude it.
+ * The disc is shaded as a sphere lit by the real sun direction, so the phase —
+ * crescent, quarter, gibbous, full, and which side is lit — falls out of where
+ * the sun is rather than being drawn. Additive over the sky: pale by day, bright
+ * with a soft halo at night.
+ *
+ * Position and phase come from resolveMoon, the same source as the moonlight.
+ */
+/** Real angular diameter is 0.52°; a true-size moon reads as a dot on a screen. */
+const MOON_ANGULAR_DIAMETER_DEG = 0.52 * 4;
+/** Quad half-size in disc radii — room for the wide glow. */
+const SPAN = 8.0;
+const vertexShader = /* glsl */ `
+varying vec2 vUv;
+void main() {
+    vUv = uv * 2.0 - 1.0;
+    gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}
+`;
+const fragmentShader = /* glsl */ `
+uniform vec3 uSunLocal;
+uniform float uNight;
+uniform float uIllum;
+varying vec2 vUv;
+
+float hash(vec2 p) { return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453); }
+float noise(vec2 p) {
+    vec2 i = floor(p), f = fract(p);
+    vec2 u = f * f * (3.0 - 2.0 * f);
+    return mix(mix(hash(i), hash(i + vec2(1, 0)), u.x), mix(hash(i + vec2(0, 1)), hash(i + vec2(1, 1)), u.x), u.y);
+}
+float fbm(vec2 p) {
+    float v = 0.0, a = 0.5;
+    for (int i = 0; i < 5; i++) { v += a * noise(p); p = p * 2.03 + 17.1; a *= 0.5; }
+    return v;
+}
+
+void main() {
+    vec2 p = vUv * ${SPAN.toFixed(1)};
+    float r = length(p);
+    float aa = fwidth(r) * 1.5;
+    float disc = 1.0 - smoothstep(1.0 - aa, 1.0 + aa, r);
+
+    // The visible hemisphere as a sphere facing the camera (z toward the viewer).
+    vec3 n = vec3(p, sqrt(max(0.0, 1.0 - r * r)));
+    float lit = smoothstep(-0.04, 0.10, dot(n, uSunLocal));
+
+    // Maria: dark low-frequency patches; fine grain on top.
+    float maria = smoothstep(0.42, 0.62, fbm(n.xy * 2.2 + 3.1));
+    float grain = fbm(n.xy * 14.0) * 0.12;
+    vec3 albedo = mix(vec3(0.58, 0.58, 0.57), vec3(0.96, 0.95, 0.91), maria) * (0.94 + grain);
+    float limb = 0.72 + 0.28 * n.z;
+    vec3 surface = albedo * limb * (lit + 0.03);   // + earthshine on the dark side
+
+    // Glow: a tight corona hugging the limb plus a wide soft bloom — moonlight
+    // scattered by the air around the disc. Scales with how much of the moon is
+    // lit and with the night; gone by day, when the sky out-shines it.
+    float d = max(r - 1.0, 0.0);
+    float glow = (exp(-d * 3.2) * 0.55 + exp(-d * 0.75) * 0.16) * (1.0 - disc);
+    vec3 col = surface * disc * mix(0.45, 1.15, uNight)
+             + vec3(0.72, 0.80, 1.0) * glow * uIllum * uNight;
+    gl_FragColor = vec4(col, 1.0);
+}
+`;
+const smooth01 = (edge0, edge1, x) => {
+    const t = THREE.MathUtils.clamp((x - edge0) / (edge1 - edge0), 0, 1);
+    return t * t * (3 - 2 * t);
+};
+const MoonDisc = ({ timeSettings, skySettings, size = 1 }) => {
+    const meshRef = useRef(null);
+    const { update } = useCloudSun({ skySettings, timeSettings });
+    const moon = useRef({ direction: new THREE.Vector3(), illumination: 1 });
+    const scratch = useMemo(() => ({ q: new THREE.Quaternion(), v: new THREE.Vector3() }), []);
+    const geometry = useMemo(() => new THREE.PlaneGeometry(2, 2), []);
+    const material = useMemo(() => new THREE.ShaderMaterial({
+        uniforms: {
+            uSunLocal: { value: new THREE.Vector3(0, 0, 1) },
+            uNight: { value: 0 },
+            uIllum: { value: 1 },
+        },
+        vertexShader,
+        fragmentShader,
+        transparent: true,
+        depthWrite: false,
+        depthTest: true,
+        blending: THREE.AdditiveBlending,
+        fog: false,
+        toneMapped: false,
+    }), []);
+    useEffect(() => () => { geometry.dispose(); material.dispose(); }, [geometry, material]);
+    useFrame(({ camera }) => {
+        const mesh = meshRef.current;
+        if (!mesh)
+            return;
+        const sunDir = update().direction;
+        const m = resolveMoon(timeSettings, sunDir, moon.current);
+        // Below the horizon there is nothing to draw (and nothing to occlude it).
+        if (m.direction.y < -0.03) {
+            mesh.visible = false;
+            return;
+        }
+        mesh.visible = true;
+        const far = camera.far ?? 1000;
+        const dist = far * 0.9;
+        mesh.position.copy(camera.position).addScaledVector(m.direction, dist);
+        mesh.quaternion.copy(camera.quaternion);
+        const radius = dist * Math.tan(THREE.MathUtils.degToRad(MOON_ANGULAR_DIAMETER_DEG * size) / 2);
+        mesh.scale.setScalar(radius * SPAN);
+        // Sun direction in the quad's frame, so the disc is lit from where the sun is.
+        scratch.q.copy(camera.quaternion).invert();
+        material.uniforms.uSunLocal.value.copy(scratch.v.copy(sunDir).applyQuaternion(scratch.q));
+        const sunElevation = THREE.MathUtils.radToDeg(Math.asin(THREE.MathUtils.clamp(sunDir.y, -1, 1)));
+        material.uniforms.uNight.value = smooth01(2, -8, sunElevation);
+        material.uniforms.uIllum.value = m.illumination;
+    });
+    return _jsx("mesh", { ref: meshRef, geometry: geometry, material: material, frustumCulled: false, renderOrder: -1 });
+};
+export default MoonDisc;

package/dist/components/ObjectNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAkBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA+IzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAkBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA8IzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -1,21 +1,22 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useMemo } from "react";
 import CustomPrimitive from "./CustomPrimitive.js";
 import CreatedObject from "./CreatedObject.js";
-import Text3D from './Text3D.js';
-import Text2D from './Text2D.js';
 import PathRenderer from './PathRenderer.js';
 import GalleryLayout from './GalleryLayout.js';
 import EffectsGenerator from './EffectsGenerator.js';
 import ParticlesGenerator from './ParticlesGenerator.js';
 import LightObject from "./LightObject.js";
 import EnvironmentObject from "./EnvironmentObject.js";
+import LandObject from "./LandObject.js";
+import TextGenerator from "./TextGenerator.js";
 import Galaxy from "./Galaxy.js";
 import GridGenerator from "./GridsGenerator.js";
 import OceanBuilder from "./OceanBuilder.js";
 import LandscapeObject from "./LandscapeObject.js";
 import LayoutInstances from "./LayoutInstances.js";
 import { useRuntimeSettings } from "../hooks/useRuntimeSettings.js";
+import { usePresentedVisibility } from "../operations/usePresentedVisibility.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
 import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig } from "@3driseai/3drise-core";
 // Slots after the first render with no ready callbacks: one object reports once.
@@ -51,7 +52,9 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
     const { children } = node;
     // Authored settings + any applied action patches (runtime only). Every renderer
     // below sees the patched object, so an action can change anything an edit can.
-    const createdObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
+    const runtimeObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
+    // An object whose effects follow its visibility stays drawn until they have played out.
+    const createdObject = usePresentedVisibility(runtimeObject);
     // Children describe themselves with their own settings; the scene above
     // knows them by the node's createdObject, so relabel on the way up.
     const relabel = useCallback((obj) => ({
@@ -88,12 +91,8 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         //         handleObjectClick={handleObjectClick}
         //     />
         // ),
-        text: (obj, onObjectReady) => {
-            const renderMode = obj.config?.renderMode ?? 'bitmap';
-            return (_jsx(_Fragment, { children: renderMode === 'text3d'
-                    ? _jsx(Text3D, { textSettings: obj, ...relabel(obj) })
-                    : _jsx(Text2D, { textSettings: obj, ...relabel(obj) }) }));
-        },
+        // Text looks (config.type: plain, handwriting, neonTube, …) render through TextGenerator.
+        text: (obj, onObjectReady) => (_jsx(TextGenerator, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         particles: (obj, onObjectReady) => {
             // Generative particle objects (config.type) render through ParticlesGenerator;
             // the legacy shape particles keep their own path.
@@ -127,6 +126,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         light: (obj, _onObjectReady, slot = 0) => (_jsx(LightObject, { createdObject: slot === 0 ? obj : withoutShadow(obj), ...(slot === 0 ? relabel(obj) : NO_READY) })),
         environment: (obj, onObjectReady) => (_jsx(EnvironmentObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         space: (obj, onObjectReady) => (_jsx(Galaxy, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
+        land: (obj, onObjectReady) => (_jsx(LandObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         // rain: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
         //     <Rain
         //         settings={obj}

package/dist/components/ObjectsRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAuFlD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwFlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/ObjectsRenderer.js

@@ -6,6 +6,7 @@ import useInteraction from '../hooks/useInteraction.js';
 import { ObjectHoverContext, setEffectPrewarmer, setEffectPreviewer, setInteractionRunner } from '../interactions/runner.js';
 import { prewarmEffect, previewEffect, previewEffects } from '../operations/runtime.js';
 import { findById } from '../utils/sceneQuery.js';
+import { actionEffectsOf, commandsOf, effectsOf } from '../triggers/index.js';
 import { useObjectReady } from '../hooks/useObjectReady.js';
 const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSettings, onObjectsReady, onObjectReady, onObjectDispose, handleObjectClick, sequences = [], clips = [], actionSequences = [], }) => {
     const groupRef = useRef(null);
@@ -53,9 +54,10 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
         if (!ref || !createdObject)
             return false;
         if (opts?.preview) {
-            // effects play and come back; animations and actions run as usual
-            executeInteraction({ interaction: { ...interaction, effects: [] }, ref, createdObject });
-            void previewEffects(interaction.effects ?? [], ref);
+            // effects play and come back; everything else runs as usual
+            const commands = commandsOf(interaction);
+            executeInteraction({ interaction: { mouseEvent: interaction.mouseEvent, enabled: interaction.enabled, commands: commands.filter(c => c.kind !== 'effect') }, ref, createdObject });
+            void previewEffects(commands.flatMap(c => (c.kind === 'effect' ? [c.effect] : [])), ref);
         }
         else {
             executeInteraction({ interaction, ref, createdObject });
@@ -79,11 +81,11 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
                 if (!ref)
                     continue;
                 for (const ix of (o.actions ?? []))
-                    for (const e of ix?.effects ?? [])
+                    for (const e of effectsOf(ix))
                         void prewarmEffect(e, ref);
             }
             for (const a of actionSequences ?? [])
-                for (const e of a.effects ?? [])
+                for (const e of actionEffectsOf(a))
                     void prewarmEffect(e, null);
         }, 1500);
         return () => clearTimeout(t);

package/dist/components/OceanBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OceanBuilder.d.ts","sourceRoot":"","sources":["../../src/components/OceanBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD;;uEAEmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAmC7C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"OceanBuilder.d.ts","sourceRoot":"","sources":["../../src/components/OceanBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD;;uEAEmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAqC7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/OceanBuilder.js

@@ -39,6 +39,8 @@ const OceanBuilder = ({ settings, skySettings, timeSettings, sunIntensity, onObj
         sunIntensity,
         id: settings?.id,
         meshSettings: settings?.meshSettings,
+        animations: settings?.animations,
+        mouseMove: settings?.mouseMove,
         onObjectReady,
         onObjectDispose,
     };

package/dist/components/ParastichyGrid.d.ts

@@ -12,7 +12,7 @@ export interface ParastichyGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ParastichyGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ParastichyGridConfig defaults: the core registry entry (DEFAULT_GRIDS.parastichyGrid), never a copy. */
 export declare const defaultParastichyGridConfig: ParastichyGridConfig;
 /**
  * The sunflower's crossed Fibonacci spiral families as a grid of their own: sectionSize spirals one way, sectionSize/φ the other, every crossing a seed, and the difference family cutting each cell into triangles. Light runs inward along the spirals.

package/dist/components/ParastichyGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParastichyGrid.d.ts","sourceRoot":"","sources":["../../src/components/ParastichyGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,iGAAiG;AACjG,eAAO,MAAM,2BAA2B,EAAE,oBA2BzC,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAoC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,mBAAmB,+BA4CjK;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ParastichyGrid.d.ts","sourceRoot":"","sources":["../../src/components/ParastichyGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,2GAA2G;AAC3G,eAAO,MAAM,2BAA2B,EAA8C,oBAAoB,CAAC;AAW3G;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAoC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,mBAAmB,+BA4CjK;AAED,eAAe,cAAc,CAAC"}

package/dist/components/ParastichyGrid.js

@@ -6,38 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ParastichyGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ParastichyGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <parastichyGridMaterial> via extend().
 void ParastichyGridMaterial;
-/** ParastichyGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultParastichyGridConfig = {
-    cellSize: 1.2,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 1.1,
-    sectionSize: 21,
-    sectionWidth: 0.9,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.5,
-    displace: 0,
-    divergence: 137.508,
-    third: 0.45,
-    sap: 0.9,
-    fill: 0.35,
-    lineColor: '#d4ac4e',
-    sectionColor: '#7fb8a8',
-    cellColor: '#0f3a33',
-    glowColor: '#fff0b8',
-    bgColor: '#03080a',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ParastichyGridConfig defaults: the core registry entry (DEFAULT_GRIDS.parastichyGrid), never a copy. */
+export const defaultParastichyGridConfig = DEFAULT_GRIDS.parastichyGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['divergence', 'third', 'sap', 'fill'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/ParticlesGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticlesGenerator.d.ts","sourceRoot":"","sources":["../../src/components/ParticlesGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAa7D,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,2BAA2B,CAAC;IACtC,uFAAuF;IACvF,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,0FAA0F;AAC1F,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAmBzD,CAAC;AACF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"ParticlesGenerator.d.ts","sourceRoot":"","sources":["../../src/components/ParticlesGenerator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA8B7D,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,2BAA2B,CAAC;IACtC,uFAAuF;IACvF,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,0FAA0F;AAC1F,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAwBzD,CAAC;AACF,eAAe,kBAAkB,CAAC"}

package/dist/components/ParticlesGenerator.js

@@ -1,15 +1,30 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import TidalStreamParticles from './particles/TidalStreamParticles.js';
-import BrownianDustParticles from './particles/BrownianDustParticles.js';
-import BioluminescentWakeParticles from './particles/BioluminescentWakeParticles.js';
-import ElectronOrbitalsParticles from './particles/ElectronOrbitalsParticles.js';
-import GrinderSparksParticles from './particles/GrinderSparksParticles.js';
-import ChladniSandParticles from './particles/ChladniSandParticles.js';
-import FaradayPowderParticles from './particles/FaradayPowderParticles.js';
-import NeonRainParticles from './particles/NeonRainParticles.js';
-import MagneticBottleParticles from './particles/MagneticBottleParticles.js';
-import ShapeBurstParticles from './particles/ShapeBurstParticles.js';
-import ShapeFlowParticles from './particles/ShapeFlowParticles.js';
+import PickVolume from './PickVolume.js';
+import TidalStreamParticles, { BOUNDS as TIDALSTREAM_BOUNDS } from './particles/TidalStreamParticles.js';
+import BrownianDustParticles, { BOUNDS as BROWNIANDUST_BOUNDS } from './particles/BrownianDustParticles.js';
+import BioluminescentWakeParticles, { BOUNDS as BIOLUMINESCENTWAKE_BOUNDS } from './particles/BioluminescentWakeParticles.js';
+import ElectronOrbitalsParticles, { BOUNDS as ELECTRONORBITALS_BOUNDS } from './particles/ElectronOrbitalsParticles.js';
+import GrinderSparksParticles, { BOUNDS as GRINDERSPARKS_BOUNDS } from './particles/GrinderSparksParticles.js';
+import ChladniSandParticles, { BOUNDS as CHLADNISAND_BOUNDS } from './particles/ChladniSandParticles.js';
+import FaradayPowderParticles, { BOUNDS as FARADAYPOWDER_BOUNDS } from './particles/FaradayPowderParticles.js';
+import NeonRainParticles, { BOUNDS as NEONRAIN_BOUNDS } from './particles/NeonRainParticles.js';
+import MagneticBottleParticles, { BOUNDS as MAGNETICBOTTLE_BOUNDS } from './particles/MagneticBottleParticles.js';
+import ShapeBurstParticles, { BOUNDS as SHAPEBURST_BOUNDS } from './particles/ShapeBurstParticles.js';
+import ShapeFlowParticles, { BOUNDS as SHAPEFLOW_BOUNDS } from './particles/ShapeFlowParticles.js';
+/** Each variant's pick volume (sim units, × size): the same sphere it culls itself with. */
+const PICK_BOUNDS = {
+    tidalStream: TIDALSTREAM_BOUNDS,
+    brownianDust: BROWNIANDUST_BOUNDS,
+    bioluminescentWake: BIOLUMINESCENTWAKE_BOUNDS,
+    electronOrbitals: ELECTRONORBITALS_BOUNDS,
+    grinderSparks: GRINDERSPARKS_BOUNDS,
+    chladniSand: CHLADNISAND_BOUNDS,
+    faradayPowder: FARADAYPOWDER_BOUNDS,
+    neonRain: NEONRAIN_BOUNDS,
+    magneticBottle: MAGNETICBOTTLE_BOUNDS,
+    shapeBurst: SHAPEBURST_BOUNDS,
+    shapeFlow: SHAPEFLOW_BOUNDS,
+};
 /** Standalone generative particle objects (type 'particles'), switched on config.type. */
 const ParticlesGenerator = ({ settings, mouseMove, onObjectReady, onObjectDispose }) => {
     const { config, animations } = settings;
@@ -17,19 +32,24 @@ const ParticlesGenerator = ({ settings, mouseMove, onObjectReady, onObjectDispos
         return null;
     const size = config.size ?? 1;
     const ready = { onObjectReady, onObjectDispose, mouseMove };
-    switch (config.type) {
-        case 'tidalStream': return _jsx(TidalStreamParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'brownianDust': return _jsx(BrownianDustParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'bioluminescentWake': return _jsx(BioluminescentWakeParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'electronOrbitals': return _jsx(ElectronOrbitalsParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'grinderSparks': return _jsx(GrinderSparksParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'chladniSand': return _jsx(ChladniSandParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'faradayPowder': return _jsx(FaradayPowderParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'neonRain': return _jsx(NeonRainParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'magneticBottle': return _jsx(MagneticBottleParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'shapeBurst': return _jsx(ShapeBurstParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        case 'shapeFlow': return _jsx(ShapeFlowParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
-        default: return null;
+    // Hover / click hit the system's volume (its own culling sphere, × size), never a sprite.
+    const b = PICK_BOUNDS[config.type] ?? { center: [0, 0, 0], radius: 1.3 };
+    return _jsx(PickVolume, { center: [b.center[0] * size, b.center[1] * size, b.center[2] * size], radius: b.radius * size * 1.05, children: variant() });
+    function variant() {
+        switch (config.type) {
+            case 'tidalStream': return _jsx(TidalStreamParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'brownianDust': return _jsx(BrownianDustParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'bioluminescentWake': return _jsx(BioluminescentWakeParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'electronOrbitals': return _jsx(ElectronOrbitalsParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'grinderSparks': return _jsx(GrinderSparksParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'chladniSand': return _jsx(ChladniSandParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'faradayPowder': return _jsx(FaradayPowderParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'neonRain': return _jsx(NeonRainParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'magneticBottle': return _jsx(MagneticBottleParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'shapeBurst': return _jsx(ShapeBurstParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            case 'shapeFlow': return _jsx(ShapeFlowParticles, { id: settings.id, size: size, config: config, animations: animations, ...ready });
+            default: return null;
+        }
     }
 };
 export default ParticlesGenerator;

package/dist/components/PhyllotaxisGrid.d.ts

@@ -12,7 +12,7 @@ export interface PhyllotaxisGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** PhyllotaxisGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** PhyllotaxisGridConfig defaults: the core registry entry (DEFAULT_GRIDS.phyllotaxisGrid), never a copy. */
 export declare const defaultPhyllotaxisGridConfig: PhyllotaxisGridConfig;
 /**
  * Vogel's sunflower: florets at the golden angle, each a lit dome coloured by age and carrying a mark aligned to the head's radius. Bloom rings travel from the rim to the centre and open the marks; the head itself never turns.

package/dist/components/PhyllotaxisGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhyllotaxisGrid.d.ts","sourceRoot":"","sources":["../../src/components/PhyllotaxisGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,EAAE,qBA6B1C,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAqC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,oBAAoB,+BAsDpK;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"PhyllotaxisGrid.d.ts","sourceRoot":"","sources":["../../src/components/PhyllotaxisGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,6GAA6G;AAC7G,eAAO,MAAM,4BAA4B,EAA+C,qBAAqB,CAAC;AAW9G;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAqC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,oBAAoB,+BAsDpK;AAED,eAAe,eAAe,CAAC"}

package/dist/components/PhyllotaxisGrid.js

@@ -7,40 +7,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { PhyllotaxisGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { PhyllotaxisGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <phyllotaxisGridMaterial> via extend().
 void PhyllotaxisGridMaterial;
-/** PhyllotaxisGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultPhyllotaxisGridConfig = {
-    cellSize: 1.6,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 0.6,
-    sectionSize: 2,
-    sectionWidth: 1.4,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.6,
-    displace: 0,
-    divergence: 137.508,
-    bloomRate: 0.04,
-    relief: 0.8,
-    shape: 1,
-    shapeSize: 0.85,
-    shapeGlow: 0.9,
-    lineColor: '#a8661c',
-    sectionColor: '#ffcf70',
-    cellColor: '#3a1a08',
-    glowColor: '#e4ee8a',
-    bgColor: '#070402',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** PhyllotaxisGridConfig defaults: the core registry entry (DEFAULT_GRIDS.phyllotaxisGrid), never a copy. */
+export const defaultPhyllotaxisGridConfig = DEFAULT_GRIDS.phyllotaxisGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['divergence', 'bloomRate', 'relief', 'shape', 'shapeSize', 'shapeGlow'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/PickVolume.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+export interface PickVolumeProps {
+    /** Sphere centre and radius in world units of the parent (already multiplied by the object's size). */
+    center?: [number, number, number];
+    radius: number;
+    children: React.ReactNode;
+}
+/**
+ * Hover / click land on one invisible sphere over a generative object's volume, never on what it draws: the
+ * sprites of a particle system live on the GPU (the CPU attributes are seeds, not positions), an effect's points
+ * are sparse, and a user who clicks a cloud means the cloud. The children are taken out of raycasting as they
+ * appear (a build can add meshes after mount), so the sphere is the only hit target. Its geometry also gives the
+ * selection gizmo a true bounding box.
+ */
+declare const PickVolume: React.FC<PickVolumeProps>;
+export default PickVolume;
+//# sourceMappingURL=PickVolume.d.ts.map

package/dist/components/PickVolume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickVolume.d.ts","sourceRoot":"","sources":["../../src/components/PickVolume.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAK1D,MAAM,WAAW,eAAe;IAC5B,uGAAuG;IACvG,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAWzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/PickVolume.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from 'react';
+import { useFrame } from '@react-three/fiber';
+import { pickSphere, stopRaycast } from '../utils/pickProxy.js';
+/**
+ * Hover / click land on one invisible sphere over a generative object's volume, never on what it draws: the
+ * sprites of a particle system live on the GPU (the CPU attributes are seeds, not positions), an effect's points
+ * are sparse, and a user who clicks a cloud means the cloud. The children are taken out of raycasting as they
+ * appear (a build can add meshes after mount), so the sphere is the only hit target. Its geometry also gives the
+ * selection gizmo a true bounding box.
+ */
+const PickVolume = ({ center = [0, 0, 0], radius, children }) => {
+    const inner = useRef(null);
+    const proxy = useMemo(() => pickSphere(), []);
+    useEffect(() => () => { proxy.geometry.dispose(); proxy.material.dispose(); }, [proxy]);
+    useFrame(() => { if (inner.current)
+        stopRaycast(inner.current); });
+    return (_jsxs("group", { children: [_jsx("primitive", { object: proxy, position: center, scale: [radius, radius, radius] }), _jsx("group", { ref: inner, children: children })] }));
+};
+export default PickVolume;

package/dist/components/ProjectLoader.d.ts

@@ -1,5 +1,5 @@
 import type { SceneHandle } from "../api/sceneHandle";
-import type { CreatedObjectSettings, HtmlElement } from '@3driseai/3drise-core';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
 import React from "react";
 import { Object3D } from "three";
 import { type ThreeEvent } from "@react-three/fiber";
@@ -9,8 +9,10 @@ declare const ProjectLoader: React.ForwardRefExoticComponent<ObjectReadyProps &
     loadingIndicator?: React.ReactNode;
     onObjectClick?: (object: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
     onObjectHover?: (object: CreatedObjectSettings, ref: Object3D) => void;
-    onElementClick?: (element: HtmlElement) => void;
-    onElementHover?: (element: HtmlElement | null) => void;
+    /** Render the project's UI layers over the scene (default true). `false` leaves the scene bare, for your own UI. */
+    ui?: boolean;
+    /** CSS appended to every UI layer after its own — restyle the generic rise-* classes or set --rise-* variables. */
+    uiStyles?: string;
     onSceneInitialized?: () => void;
     /**
      * Called once the project is loaded and its canvas exists, with the handle for

package/dist/components/ProjectLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkB7D,QAAA,MAAM,aAAa;eAhBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;qBACrD,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI;qBAC9B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI;yBACjC,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA0D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAInE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAoB7D,QAAA,MAAM,aAAa;eAlBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;IACtE,oHAAoH;SAC/G,OAAO;IACZ,mHAAmH;eACxG,MAAM;yBACI,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA4D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/ProjectLoader.js

@@ -3,9 +3,10 @@ import { forwardRef, useEffect, useState } from "react";
 import { dataCenterServer } from '../constants.js';
 import SceneBuilder from "./SceneBuilder.js";
 import { loadAssets, } from "@3driseai/3drise-core";
+import { migrateObject } from '@3driseai/3drise-core';
 import LoadingIndicator from "./LoadingIndicator.js";
 import { useMeshController } from "../hooks/useMeshController.js";
-const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onElementClick, onElementHover, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
+const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, ui = true, uiStyles, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
     const [project, setProject] = useState(null);
     const meshController = useMeshController();
     useEffect(() => {
@@ -30,7 +31,9 @@ const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onE
                 throw new Error(`HTTP error! status: ${response.status}`);
             }
             const responseData = await response.json();
-            const sceneObjects = responseData.sceneObjects || [];
+            // Legacy space configs (the starfield's rotateSpeed) -> the space family's shape.
+            const sceneObjects = (responseData.sceneObjects || []).map(migrateObject);
+            responseData.sceneObjects = sceneObjects;
             const modelObjects = sceneObjects.filter(obj => obj.type === 'model');
             const meshObjects = sceneObjects.filter(obj => obj.type === 'mesh');
             try {
@@ -56,7 +59,7 @@ const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, onE
                 flexDirection: 'column', gap: '1rem'
             }, children: loadingIndicator });
     }
-    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, onSceneInitialized: onSceneInitialized, onUiElementClick: onElementClick, onUiElementHover: onElementHover, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
+    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, loadingIndicator: loadingIndicator, onSceneInitialized: onSceneInitialized, ui: ui, uiStyles: uiStyles, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
 });
 ProjectLoader.displayName = 'ProjectLoader';
 export default ProjectLoader;

package/dist/components/QuasiGrid.d.ts

@@ -12,7 +12,7 @@ export interface QuasiGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** QuasiGridConfig — the single source of truth for a quasicrystal grid instance. */
+/** QuasiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.quasiGrid), never a copy. */
 export declare const defaultQuasiGridConfig: QuasiGridConfig;
 export declare function QuasiGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: QuasiGridProps): import("react").JSX.Element;
 export default QuasiGrid;

package/dist/components/QuasiGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuasiGrid.d.ts","sourceRoot":"","sources":["../../src/components/QuasiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,eA2BpC,CAAC;AAqBF,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"QuasiGrid.d.ts","sourceRoot":"","sources":["../../src/components/QuasiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,EAAyC,eAAe,CAAC;AAqB5F,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}