@3driseai/3drise-viewer 0.1.22 → 0.1.24

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

@@ -1 +1 @@
-{"version":3,"file":"CreatedObject.d.ts","sourceRoot":"","sources":["../../src/components/CreatedObject.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAUnE,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,kBAAmB,SAAQ,gBAAgB;IACjD,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAmF9C,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"CreatedObject.d.ts","sourceRoot":"","sources":["../../src/components/CreatedObject.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAWnE,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,kBAAmB,SAAQ,gBAAgB;IACjD,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuF9C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/CreatedObject.js

@@ -4,6 +4,7 @@ import { ModelMaterialPassContext } from "./ModelMaterialPassContext.js";
 import { DEFAULT_EDGES_SETTINGS } from "@3driseai/3drise-core";
 import { useMaterialApplication } from "../hooks/useMaterialApplication.js";
 import { useShadowApplication } from "../hooks/useShadowApplication.js";
+import { resolveShadowFlags } from '@3driseai/3drise-core';
 import { useTransformControls } from "../hooks/useTransformControls.js";
 import { RigidBody } from '@react-three/rapier';
 import { cameraManager } from "../utils/CameraSingleton.js";
@@ -34,7 +35,11 @@ const CreatedObject = memo(({ createdObject, children, shouldApply3driseMaterial
     // (useNodeOverrides in ModelPrimitive) re-apply on top of it.
     const [materialPass, bumpMaterialPass] = useReducer((n) => n + 1, 0);
     useMaterialApplication(meshRef, createdObject.materialSettings, shouldApply3driseMaterial, bumpMaterialPass);
-    useShadowApplication(meshRef, createdObject.meshSettings.castShadow, createdObject.meshSettings.receiveShadow);
+    // An object with no explicit flags takes its type's defaults (core's
+    // resolveShadowFlags): saved objects carry none, and reading them as false
+    // switched every shadow in every project off.
+    const shadowFlags = resolveShadowFlags(createdObject.type, createdObject.meshSettings);
+    useShadowApplication(meshRef, shadowFlags.castShadow, shadowFlags.receiveShadow);
     const anchoredPosition = cameraManager.getAnchorPosition(createdObject.meshSettings.anchor?.anchor || 'center', 0, createdObject.meshSettings.anchor?.offset || { y: 0, x: 0, z: 0 }, createdObject.meshSettings.anchor?.padding || 0);
     useEffect(() => {
         if (meshRef.current) {

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

@@ -1 +1 @@
-{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAO7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAkDF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAmB3C,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAUnE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AA+CF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA+B3C,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/LightObject.js

@@ -3,17 +3,18 @@ import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useRef } from 'react';
 import { useThree } from '@react-three/fiber';
 import { useLightShadow } from '../hooks/useLightShadow.js';
-import { useLightAnimation } from '../hooks/useLightAnimation.js';
-import { useLightMouseMove } from '../hooks/useLightMouseMove.js';
-import { useLightLive } from '../hooks/useLightLive.js';
+import { useLightConfig } from '../hooks/useLightConfig.js';
 import LightBulb from './lightBulb/LightBulb.js';
+import SpotBeam from './spotBeam/SpotBeam.js';
+import LedArray from './ledArray/LedArray.js';
+import FluorescentTube from './fluorescentTube/FluorescentTube.js';
+import Candle from './candle/Candle.js';
 const DirectionalLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const lightRef = useRef(null);
     useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
     useLightShadow(lightRef, config.shadow);
-    useLightAnimation(lightRef, animations);
-    useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
-    useLightLive(lightRef, lightRef, settings?.id, config);
+    // Keyframes, pointer bindings and live drags, merged onto the light.
+    useLightConfig(lightRef, lightRef, settings?.id, config, animations, mouseMove);
     return (_jsx("directionalLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1 }));
 };
 const SpotLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
@@ -40,18 +41,16 @@ const SpotLightR3F = ({ config, animations, mouseMove, settings, onObjectReady,
         };
     }, [scene, tx, ty, tz]);
     useLightShadow(lightRef, config.shadow);
-    useLightAnimation(lightRef, animations);
-    useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
-    useLightLive(lightRef, lightRef, settings?.id, config);
-    return (_jsx("spotLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1, angle: config.angle ?? Math.PI / 4, penumbra: config.penumbra ?? 0.1, decay: config.decay ?? 1, distance: config.distance ?? 0 }));
+    // Keyframes, pointer bindings and live drags, merged onto the light.
+    useLightConfig(lightRef, lightRef, settings?.id, config, animations, mouseMove);
+    return (_jsx("spotLight", { ref: lightRef, position: [0, 0, 0], color: config.color || '#ffffff', intensity: config.intensity ?? 1, angle: config.angle ?? Math.PI / 4, penumbra: config.penumbra ?? 0.1, decay: config.decay ?? 1, distance: config.distance ?? 0 }));
 };
 const PointLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const lightRef = useRef(null);
     useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
     useLightShadow(lightRef, config.shadow);
-    useLightAnimation(lightRef, animations);
-    useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
-    useLightLive(lightRef, lightRef, settings?.id, config);
+    // Keyframes, pointer bindings and live drags, merged onto the light.
+    useLightConfig(lightRef, lightRef, settings?.id, config, animations, mouseMove);
     return (_jsx("pointLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1, decay: config.decay ?? 1, distance: config.distance ?? 0 }));
 };
 const LightObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
@@ -67,6 +66,18 @@ const LightObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
             return _jsx(SpotLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         case 'point':
             return _jsx(PointLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
+        // A raymarched flame with its own physics, and the wax under it.
+        case 'candle':
+            return _jsx(Candle, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
+        // An array of LED dies: instant on, PWM ripple, optional diffuser.
+        case 'ledArray':
+            return _jsx(LedArray, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
+        // A bank of tubes lit by a rect-area light, with the ballast's behaviour.
+        case 'fluorescentTube':
+            return _jsx(FluorescentTube, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
+        // A spot light you can see: procedural gobo + a beam in the air.
+        case 'spotBeam':
+            return _jsx(SpotBeam, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         // A visible bulb: point light + glass/filament/base + self-drawn glow.
         case 'lightBulb':
             return _jsx(LightBulb, { id: createdObject.id, config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });

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

@@ -1 +1 @@
-{"version":3,"file":"ModelPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/ModelPrimitive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,aAAa,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA4ChD,CAAC;AAIH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ModelPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/ModelPrimitive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,aAAa,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA0ChD,CAAC;AAIH,eAAe,cAAc,CAAC"}

package/dist/components/ModelPrimitive.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { memo, useCallback, useMemo, useRef } from 'react';
 import { useModelObject } from '../hooks/useModelObject.js';
 import { useNodeOverrides } from '../hooks/useNodeOverrides.js';
-import { getNodeOverrides, peekModelAsset } from '@3driseai/3drise-core';
+import { getNodeOverrides, peekModelAsset, resolveShadowFlags } from '@3driseai/3drise-core';
 import { useObjectReadyReporter } from '../hooks/useObjectReady.js';
 import { applyShadowFlags } from '../hooks/useShadowApplication.js';
 /**
@@ -44,11 +44,9 @@ const ModelPrimitive = memo(({ createdObject, slot = 0, onObjectReady, onObjectD
     // change. A model that suspended attaches after that mount, so it gets them here.
     // Read through a ref: a changing callback ref would detach/attach the object and
     // fire a spurious onObjectDispose / onObjectReady pair on every shadow toggle.
-    const shadowFlags = useRef({});
-    shadowFlags.current = {
-        cast: createdObject.meshSettings?.castShadow,
-        receive: createdObject.meshSettings?.receiveShadow,
-    };
+    const shadowFlags = useRef({ cast: false, receive: false });
+    const resolved = resolveShadowFlags(createdObject.type, createdObject.meshSettings);
+    shadowFlags.current = { cast: resolved.castShadow, receive: resolved.receiveShadow };
     const setObjectRef = useCallback((instance) => {
         if (instance) {
             applyShadowFlags(instance, shadowFlags.current.cast, shadowFlags.current.receive);

package/dist/components/ObjectNode.js

@@ -93,7 +93,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         particles: (obj, onObjectReady) => {
             // Generative particle objects (config.type) render through ParticlesGenerator;
             // the legacy shape particles keep their own path.
-            return (_jsx(ParticlesGenerator, { settings: { id: obj.id, config: obj.config, animations: obj.animations }, ...relabel(obj) }, obj.id));
+            return (_jsx(ParticlesGenerator, { settings: { id: obj.id, config: obj.config, animations: obj.animations }, mouseMove: obj.mouseMove?.particles, ...relabel(obj) }, obj.id));
             // if (isGenerativeParticlesConfig(obj.config))
             //     return (<ParticlesGenerator key={obj.id} settings={{ config: obj.config }} {...relabel(obj)} />);
             // const particlesSettings = obj;

package/dist/components/ParticlesGenerator.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
-import type { GenerativeParticlesSettings } from '@3driseai/3drise-core';
+import type { GenerativeParticlesSettings, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../types/objectReady';
 export interface ParticlesGeneratorProps extends ObjectReadyProps {
     settings: GenerativeParticlesSettings;
+    /** Pointer bindings for the object's own knobs (createdObject.mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
 }
 /** Standalone generative particle objects (type 'particles'), switched on config.type. */
 declare const ParticlesGenerator: React.FC<ParticlesGeneratorProps>;

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,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU7D,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,2BAA2B,CAAC;CACzC;AAED,0FAA0F;AAC1F,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAgBzD,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;AAU7D,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,CAgBzD,CAAC;AACF,eAAe,kBAAkB,CAAC"}

package/dist/components/ParticlesGenerator.js

@@ -8,12 +8,12 @@ import ChladniSandParticles from './particles/ChladniSandParticles.js';
 import FaradayPowderParticles from './particles/FaradayPowderParticles.js';
 import NeonRainParticles from './particles/NeonRainParticles.js';
 /** Standalone generative particle objects (type 'particles'), switched on config.type. */
-const ParticlesGenerator = ({ settings, onObjectReady, onObjectDispose }) => {
+const ParticlesGenerator = ({ settings, mouseMove, onObjectReady, onObjectDispose }) => {
     const { config, animations } = settings;
     if (!config?.enabled)
         return null;
     const size = config.size ?? 1;
-    const ready = { onObjectReady, onObjectDispose };
+    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 });

package/dist/components/ProjectLoader.js

@@ -22,7 +22,7 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
                     "Content-Type": "application/json",
                 },
             });
-            console.log(response);
+            // console.log(response)
             if (!response.ok) {
                 if (response.status === 404) {
                     throw new Error("Project not found");

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

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAmIhE,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAuIhE,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/SceneBuilder.js

@@ -71,7 +71,11 @@ const SceneBuilder = ({ project, width = "100%", height = "100vh", style = {}, c
     const timeSettings = sceneSettings.timeSettings || sceneSettings.scene?.timeSettings || {};
     const lighting = project.lights && project.lights.length > 0 ? project.lights : [{ ...LIGHTING_PRESETS.ambient.config, enabled: true, showHelpers: false }];
     const controls = camera.controls;
-    const { shadows = false, antialias = true, dpr = window.devicePixelRatio, gl = {}, backgroundColor = "#000000" } = sceneCanvas;
+    // `shadows` defaults to ON, matching the studio's canvas defaults. A project
+    // whose sceneSettings were saved before the canvas block existed carries no
+    // `shadows` key, and defaulting to false left <Canvas> with shadowMap disabled
+    // — every castShadow / receiveShadow flag in the scene then does nothing.
+    const { shadows = true, antialias = true, dpr = window.devicePixelRatio, gl = {}, backgroundColor = "#000000" } = sceneCanvas;
     const { position, orientation, fov, near, far } = camera;
     const containerStyle = {
         width,

package/dist/components/candle/Candle.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { AnimationOptions, CreatedObjectSettings, MouseMoveDomain } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export type CandleProps = ObjectReadyProps & {
+    /** Scene object id: the light controller finds the live-edit handle by it. */
+    id?: string;
+    config: Record<string, any>;
+    animations?: AnimationOptions[];
+    mouseMove?: MouseMoveDomain;
+    settings: CreatedObjectSettings | Record<string, any>;
+};
+declare const Candle: React.FC<CandleProps>;
+export default Candle;
+//# sourceMappingURL=Candle.d.ts.map

package/dist/components/candle/Candle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Candle.d.ts","sourceRoot":"","sources":["../../../src/components/candle/Candle.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAItG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzD,CAAC;AAYF,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA+RjC,CAAC;AAKF,eAAe,MAAM,CAAC"}

package/dist/components/candle/Candle.js

@@ -0,0 +1,249 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// Candle — a real flame, and the wax it is standing on
+// =============================================================================
+//
+// Rendered by LightObject for `config.type === 'candle'`.
+//
+// The light is a PointLight sitting at the flame's *luminous centroid* — about
+// 40% of the way up, not at the wick — and it moves with the flame every frame.
+// That is what makes candlelight read as alive: the shadows sway, rather than
+// just dimming in place.
+//
+// The flame itself is raymarched (see candleMaterials) and its motion comes from
+// flameMotion, which models the buoyancy oscillation, the pink-noise wander of
+// room air, guttering, and the ignition. Switching the candle on lights it: the
+// wick catches small and blue, flares, and settles. Switching it off snuffs it
+// and leaves a wisp of smoke.
+//
+import { useEffect, useMemo, useRef } from 'react';
+import { useFrame } from '@react-three/fiber';
+import { BoxGeometry, Color, PlaneGeometry, Vector3 } from 'three';
+import { SELF_OWNED_MATERIAL_KEY } from '@3driseai/3drise-core';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useLightShadow } from '../../hooks/useLightShadow.js';
+import { useLightConfig } from '../../hooks/useLightConfig.js';
+import { kelvinToColor } from '../lightBulb/kelvin.js';
+import { createCandleMaterials, disposeCandleMaterials } from './candleMaterials.js';
+import { buildCandle, wickTipPosition } from './candleGeometry.js';
+import { createFlameMotion, stepFlameMotion } from './flameMotion.js';
+const num = (v, d) => (typeof v === 'number' && Number.isFinite(v) ? v : d);
+const clamp01 = (v) => Math.min(Math.max(v, 0), 1);
+/** Headroom above the flame's nominal height, so draught can stretch it. */
+const BOX_TALL = 1.55;
+// Kept tight to the flame on purpose: the march is over the whole box, so a
+// roomy box spends most of its steps on empty air and bands where the flame is
+// thin. Wide enough for the lean and the undulation, and no wider.
+const BOX_WIDE = 0.85;
+const Candle = ({ id, config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
+    const groupRef = useRef(null);
+    const lightRef = useRef(null);
+    const waxLightRef = useRef(null);
+    const flameRef = useRef(null);
+    const billboardRef = useRef(null);
+    const smokeRef = useRef(null);
+    const haloRef = useRef(null);
+    const emberRef = useRef(null);
+    useObjectReady(groupRef, settings, onObjectReady, onObjectDispose);
+    useLightShadow(lightRef, config.shadow);
+    const { merged } = useLightConfig(groupRef, lightRef, id, config, animations, mouseMove);
+    const body = (config.body ?? 'pillar');
+    const bodyHeight = num(config.height, 0.14);
+    const bodyRadius = num(config.radius, 0.028);
+    const meltAmount = num(config.melt, 0.45);
+    // The wick's curl had been aimed by the draught-angle knob. That knob is
+    // gone, so it comes from the object's own id: stable across frames, and two
+    // candles side by side do not curl the same way.
+    const wickAngle = useMemo(() => {
+        let h = 2166136261;
+        for (const ch of String(id ?? 'candle'))
+            h = Math.imul(h ^ ch.charCodeAt(0), 16777619);
+        return ((h >>> 0) % 1000) / 1000 * Math.PI * 2;
+    }, [id]);
+    const flameHeight = Math.max(num(config.flameHeight, 0.055), 0.004);
+    const flameWidth = Math.max(num(config.flameWidth, 1), 0.15);
+    const flameMode = (config.flameMode ?? 'volumetric');
+    const candle = useMemo(() => buildCandle(body, bodyHeight, bodyRadius, meltAmount, wickAngle), [body, bodyHeight, bodyRadius, meltAmount, wickAngle]);
+    useEffect(() => () => candle.dispose(), [candle]);
+    const quads = useMemo(() => ({
+        box: new BoxGeometry(1, 1, 1),
+        quad: new PlaneGeometry(2, 2),
+    }), []);
+    useEffect(() => () => { quads.box.dispose(); quads.quad.dispose(); }, [quads]);
+    const mats = useMemo(() => createCandleMaterials(), []);
+    useEffect(() => () => disposeCandleMaterials(mats), [mats]);
+    const motion = useRef(createFlameMotion(config.on ?? true));
+    const scratch = useMemo(() => ({
+        body: new Color(), core: new Color(), fringe: new Color(), tint: new Color(), cam: new Vector3(),
+    }), []);
+    const power = useRef({ base: config.intensity ?? 1, written: Number.NaN });
+    // The light owns its materials and its shadow flags; the wax sets its own.
+    useEffect(() => {
+        const group = groupRef.current;
+        if (!group)
+            return;
+        group.userData[SELF_OWNED_MATERIAL_KEY] = true;
+        return () => { delete group.userData[SELF_OWNED_MATERIAL_KEY]; };
+    }, []);
+    // The wax is centimetres from the flame; the point shadow camera's default
+    // near of 0.5 would put the whole candle outside its own shadow map.
+    const shadowNear = config.shadow?.cameraNear;
+    useEffect(() => {
+        const light = lightRef.current;
+        if (!light || shadowNear !== undefined)
+            return;
+        light.shadow.camera.near = 0.01;
+        light.shadow.camera.updateProjectionMatrix();
+    }, [shadowNear]);
+    // Wax colour and thickness track the body, not the frame loop.
+    useEffect(() => {
+        mats.wax.color.set(config.waxColor || '#f3e7d2');
+        mats.melt.color.set(config.waxColor || '#f3e7d2');
+        mats.wax.thickness = bodyRadius * 2;
+        mats.wax.attenuationDistance = Math.max(bodyRadius * 2.2, 0.01);
+    }, [mats, config.waxColor, bodyRadius]);
+    const lightColor = useMemo(() => ((config.colorMode ?? 'temperature') === 'color'
+        ? new Color(config.color || '#ffb46b')
+        : kelvinToColor(config.temperature ?? 1850)), [config.colorMode, config.color, config.temperature]);
+    // The box has to hold the flame at this draught: wind both stretches it and
+    // blows it sideways, and a flame clipped by its own bounding box is the
+    // ugliest failure this component has. Sized from the committed draught, so
+    // animating that knob moves the flame inside a box that already fits.
+    const draughtBox = Math.min(Math.max(num(config.draught, 0.08), 0), 1);
+    const boxWideF = BOX_WIDE + draughtBox * 1.6;
+    const boxTallF = BOX_TALL + draughtBox * 1.1;
+    const boxH = flameHeight * boxTallF;
+    const boxW = flameHeight * boxWideF;
+    const emberPos = useMemo(() => wickTipPosition(candle, wickAngle, bodyHeight, bodyRadius, body, meltAmount), [candle, wickAngle, bodyHeight, bodyRadius, body, meltAmount]);
+    useFrame(({ clock, camera }, delta) => {
+        const light = lightRef.current;
+        const group = groupRef.current;
+        if (!light || !group)
+            return;
+        const cfg = merged.current;
+        if (light.intensity !== power.current.written)
+            power.current.base = light.intensity;
+        const t = clock.elapsedTime;
+        const m = stepFlameMotion(motion.current, {
+            flicker: clamp01(num(cfg.flicker, 0.5)),
+            movement: clamp01(num(cfg.movement, 1)),
+            flickerHz: num(cfg.flickerHz, 11),
+            draught: clamp01(num(cfg.draught, 0.08)),
+            ignite: Math.max(num(cfg.ignite, 1.6), 0),
+            on: cfg.on ?? true,
+        }, delta);
+        // --- the light -----------------------------------------------------
+        light.intensity = power.current.base * m.output;
+        power.current.written = light.intensity;
+        // Colour: rebuilt from the config each frame (a lerp onto the light's own
+        // colour compounds), then pulled a little warmer as it dims, the way a
+        // cooling flame does.
+        const tint = scratch.tint;
+        if ((cfg.colorMode ?? 'temperature') === 'color')
+            tint.set(cfg.color || '#ffb46b');
+        else
+            kelvinToColor(num(cfg.temperature, 1850) * (0.86 + 0.14 * m.output), tint);
+        light.color.copy(tint);
+        // The luminous centroid sits low in the flame, and leans with it.
+        const cy = flameHeight * 0.42 * m.level * m.stretch;
+        const lean = Math.pow(0.42, 1.7);
+        light.position.set(m.leanX * flameHeight * lean, candle.wickTop + cy, m.leanZ * flameHeight * lean);
+        const waxLight = waxLightRef.current;
+        if (waxLight) {
+            waxLight.intensity = power.current.base * m.output * clamp01(num(cfg.waxGlow, 0.3)) * 0.22;
+            waxLight.color.copy(tint);
+        }
+        // --- the flame ------------------------------------------------------
+        const active = flameMode === 'billboard' ? mats.flameBillboard : mats.flame;
+        const u = active.uniforms;
+        u.uTime.value = t;
+        u.uLevel.value = m.level;
+        u.uPulse.value = m.pulse;
+        u.uLean.value.set(m.leanX * (flameHeight / boxW), m.leanZ * (flameHeight / boxW));
+        u.uStretch.value = m.stretch * m.pulse;
+        u.uTurb.value = m.turbulence;
+        u.uPhase.value = m.phaseOut;
+        u.uSway.value = m.sway * (flameHeight / boxW);
+        u.uSwayDir.value.set(m.swayX, m.swayZ);
+        u.uSeed.value = m.noiseSeed;
+        u.uScroll.value = m.scroll;
+        u.uShed.value = m.shed;
+        u.uShedPhase.value = m.shedPhase;
+        u.uDetach.value = m.detach;
+        u.uGap.value = 0.05;
+        // A percentage of the flame's height, as the knob is named.
+        u.uBlueHeight.value = clamp01(num(cfg.blueBasePercentage, 16) / 100);
+        u.uRadius.value = (0.193 / boxWideF) * flameWidth;
+        u.uTop.value = 1 / boxTallF;
+        u.uBlue.value = clamp01(num(cfg.blue, 0.7));
+        u.uBlueBias.value = m.blueBias;
+        // Emission and absorption are integrated per object-space unit, and a
+        // wider box makes the flame smaller in those units — so both have to be
+        // scaled by the box or a blown flame quietly goes dim and thin.
+        const boxK = boxWideF / BOX_WIDE;
+        u.uSoot.value = clamp01(num(cfg.soot, 0.25)) * boxK;
+        u.uGain.value = num(cfg.flameGain, 5) * boxK;
+        u.uWhite.value = num(cfg.flameWhite, 3.5);
+        // Keep the step density roughly constant as the box grows with the wind.
+        u.uSteps.value = Math.min(num(cfg.flameSteps, 24) * Math.sqrt(boxK), 40);
+        // The body colour is the greybody at this temperature; the core is that
+        // pushed most of the way to white, which is what the hottest soot does.
+        scratch.body.copy(tint);
+        u.uBody.value.copy(scratch.body);
+        u.uCore.value.copy(scratch.core.copy(tint).lerp(WHITE, 0.72));
+        // Cooling soot at the fringe and the tip: a deep red long before it
+        // stops glowing.
+        u.uFringe.value.copy(scratch.fringe.copy(tint).lerp(EMBER, 0.78));
+        const flame = flameRef.current;
+        const billboard = billboardRef.current;
+        const lit = m.level > 0.002;
+        if (flame) {
+            flame.visible = lit && flameMode === 'volumetric';
+            if (flame.visible) {
+                // The raymarch runs in the box's own space, so the camera goes there.
+                flame.updateMatrixWorld();
+                const cam = scratch.cam.copy(camera.position);
+                flame.worldToLocal(cam);
+                mats.flame.uniforms.uCamera.value.copy(cam);
+            }
+        }
+        if (billboard)
+            billboard.visible = lit && flameMode === 'billboard';
+        // --- wick ember, halo, smoke ---------------------------------------
+        const ember = emberRef.current;
+        if (ember) {
+            ember.visible = lit;
+            mats.ember.color.copy(tint).multiplyScalar(0.2 + m.output * 1.1);
+        }
+        const halo = haloRef.current;
+        if (halo) {
+            const haloAmount = Math.max(num(cfg.halo, 1), 0);
+            halo.visible = haloAmount > 0.001 && lit;
+            halo.position.set(light.position.x, light.position.y, light.position.z);
+            mats.halo.uniforms.uColor.value.copy(tint);
+            mats.halo.uniforms.uStrength.value = haloAmount * m.output * 0.16;
+            // Tight: the quad's half-extent is uRadius in world units, so a value
+            // near the flame's own height already covers a lot of screen up close.
+            mats.halo.uniforms.uRadius.value = flameHeight * 0.7;
+        }
+        const smoke = smokeRef.current;
+        if (smoke) {
+            smoke.visible = m.smokeAge >= 0 && (cfg.smoke ?? true) !== false;
+            if (smoke.visible) {
+                mats.smoke.uniforms.uTime.value = t;
+                mats.smoke.uniforms.uAge.value = m.smokeAge;
+                // Face the camera about Y only: a rising column should not tip.
+                const c = scratch.cam.copy(camera.position);
+                smoke.parent?.worldToLocal(c);
+                smoke.rotation.y = Math.atan2(c.x - smoke.position.x, c.z - smoke.position.z);
+            }
+        }
+    });
+    const showBody = body !== 'none';
+    return (_jsxs("group", { ref: groupRef, children: [_jsx("pointLight", { ref: lightRef, color: lightColor, intensity: config.intensity ?? 1, decay: config.decay ?? 2, distance: config.distance ?? 0 }), showBody && (_jsx("pointLight", { ref: waxLightRef, position: [0, Math.max(candle.wickTop - bodyRadius * 0.6, 0), 0], intensity: 0, decay: 2, distance: Math.max(bodyHeight, 0.02) })), showBody && (_jsxs(_Fragment, { children: [_jsx("mesh", { geometry: candle.wall, material: mats.wax, castShadow: true, receiveShadow: true }), _jsx("mesh", { geometry: candle.pool, material: mats.melt, castShadow: true, receiveShadow: true }), _jsx("mesh", { geometry: candle.base, material: mats.wax }), _jsx("mesh", { geometry: candle.wick, material: mats.wick }), _jsx("mesh", { ref: emberRef, geometry: candle.ember, material: mats.ember, position: emberPos })] })), _jsx("mesh", { ref: flameRef, geometry: quads.box, material: mats.flame, scale: [boxW, boxH, boxW], position: [0, candle.wickTop + boxH / 2, 0], renderOrder: 4, frustumCulled: false }), _jsx("mesh", { ref: billboardRef, geometry: quads.quad, material: mats.flameBillboard, scale: [boxW, boxH, 1], position: [0, candle.wickTop + boxH / 2, 0], renderOrder: 4, frustumCulled: false }), _jsx("mesh", { ref: smokeRef, geometry: quads.quad, material: mats.smoke, 
+                // Half-height is the scale, so the quad's foot lands on the wick.
+                scale: [flameHeight * 1.6, flameHeight * 2.4, 1], position: [0, candle.wickTop + flameHeight * 2.4, 0], renderOrder: 5, frustumCulled: false }), _jsx("mesh", { ref: haloRef, geometry: quads.quad, material: mats.halo, renderOrder: 6, frustumCulled: false })] }));
+};
+const WHITE = new Color(1, 1, 1);
+const EMBER = new Color(1, 0.22, 0.02);
+export default Candle;

package/dist/components/candle/candleGeometry.d.ts

@@ -0,0 +1,23 @@
+import { CircleGeometry, CylinderGeometry, LatheGeometry, SphereGeometry, TubeGeometry } from 'three';
+import type { BufferGeometry } from 'three';
+export type CandleBody = 'pillar' | 'taper' | 'tealight' | 'none';
+export declare const CANDLE_BODIES: CandleBody[];
+export interface CandleGeometry {
+    /** Outer wall, open at both ends — the caps are the pool and the base. */
+    wall: CylinderGeometry;
+    /** The melt pool: rim down into the well. */
+    pool: LatheGeometry;
+    base: CircleGeometry;
+    wick: TubeGeometry;
+    ember: SphereGeometry;
+    /** Where the wick's tip is, and so where the flame stands. */
+    wickTop: number;
+    /** Radius at the top of the body, for the pool and the halo. */
+    topRadius: number;
+    dispose(): void;
+}
+export declare function buildCandle(body: CandleBody, heightRaw: number, radiusRaw: number, meltRaw: number, leanAngle: number): CandleGeometry;
+/** The curled tip, in object space, for the ember. */
+export declare function wickTipPosition(g: CandleGeometry, leanAngle: number, height: number, radius: number, body: CandleBody, melt: number): [number, number, number];
+export type { BufferGeometry };
+//# sourceMappingURL=candleGeometry.d.ts.map

package/dist/components/candle/candleGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candleGeometry.d.ts","sourceRoot":"","sources":["../../../src/components/candle/candleGeometry.ts"],"names":[],"mappings":"AAQA,OAAO,EACe,cAAc,EAAE,gBAAgB,EAAE,aAAa,EACjE,cAAc,EAAE,YAAY,EAC/B,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAClE,eAAO,MAAM,aAAa,EAAE,UAAU,EAA4C,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,gBAAgB,CAAC;IACvB,6CAA6C;IAC7C,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,IAAI,IAAI,CAAC;CACnB;AASD,wBAAgB,WAAW,CACvB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAClB,cAAc,CAmDhB;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAO9J;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/candle/candleGeometry.js

@@ -0,0 +1,73 @@
+// =============================================================================
+// candleGeometry — the wax, the melt pool and the wick
+// =============================================================================
+//
+// Rebuilt only when a structural knob changes. The melt pool is a lathe rather
+// than a flat disc because the well is where the candle reads as lit from
+// inside: the wax is thinnest there, so that is where the flame shows through.
+//
+import { CatmullRomCurve3, CircleGeometry, CylinderGeometry, LatheGeometry, SphereGeometry, TubeGeometry, Vector2, Vector3, } from 'three';
+export const CANDLE_BODIES = ['pillar', 'taper', 'tealight', 'none'];
+/** Proportions per body style, relative to the height and radius knobs. */
+const STYLE = {
+    pillar: { top: 1, height: 1, radius: 1 },
+    taper: { top: 0.66, height: 1.9, radius: 0.55 },
+    tealight: { top: 1, height: 0.3, radius: 1.5 },
+};
+export function buildCandle(body, heightRaw, radiusRaw, meltRaw, leanAngle) {
+    const style = STYLE[(body === 'none' ? 'pillar' : body)];
+    const height = Math.max(heightRaw, 0.005) * style.height;
+    const rBase = Math.max(radiusRaw, 0.003) * style.radius;
+    const rTop = rBase * style.top;
+    const melt = Math.min(Math.max(meltRaw, 0), 1);
+    // How deep the well goes, and how far down the wick sits in it.
+    const well = Math.min(rTop * (0.12 + melt * 0.5), height * 0.5);
+    const wallTop = height;
+    const wall = new CylinderGeometry(rTop, rBase, wallTop, 48, 1, true);
+    wall.translate(0, wallTop / 2, 0);
+    // Inner-bottom → outer-top, so the normals face up and out of the dish.
+    const pool = new LatheGeometry([
+        new Vector2(0.0015, wallTop - well),
+        new Vector2(rTop * 0.34, wallTop - well * 0.86),
+        new Vector2(rTop * 0.68, wallTop - well * 0.42),
+        new Vector2(rTop * 0.93, wallTop - well * 0.08),
+        new Vector2(rTop, wallTop),
+    ], 48);
+    pool.computeVertexNormals();
+    const base = new CircleGeometry(rBase, 48);
+    base.rotateX(Math.PI / 2);
+    // A used wick is bent over and curled, not a straight bristle.
+    const wickBase = wallTop - well;
+    const wickLen = Math.max(rTop * 0.55, height * 0.045);
+    const dx = Math.cos(leanAngle), dz = Math.sin(leanAngle);
+    const wick = new TubeGeometry(new CatmullRomCurve3([
+        new Vector3(0, wickBase - wickLen * 0.25, 0),
+        new Vector3(dx * wickLen * 0.06, wickBase + wickLen * 0.35, dz * wickLen * 0.06),
+        new Vector3(dx * wickLen * 0.34, wickBase + wickLen * 0.78, dz * wickLen * 0.34),
+        new Vector3(dx * wickLen * 0.72, wickBase + wickLen * 0.92, dz * wickLen * 0.72),
+    ]), 22, Math.max(wickLen * 0.055, 0.0004), 6, false);
+    const ember = new SphereGeometry(Math.max(wickLen * 0.06, 0.0004), 10, 8);
+    return {
+        wall, pool, base, wick, ember,
+        // The flame stands part way up the wick, clear of the pool's rim — the
+        // blue base is the first thing lost if it sits down inside the well.
+        wickTop: wickBase + wickLen * 0.8,
+        topRadius: rTop,
+        dispose() {
+            wall.dispose();
+            pool.dispose();
+            base.dispose();
+            wick.dispose();
+            ember.dispose();
+        },
+    };
+}
+/** The curled tip, in object space, for the ember. */
+export function wickTipPosition(g, leanAngle, height, radius, body, melt) {
+    const style = STYLE[(body === 'none' ? 'pillar' : body)];
+    const h = Math.max(height, 0.005) * style.height;
+    const rTop = Math.max(radius, 0.003) * style.radius * style.top;
+    const well = Math.min(rTop * (0.12 + Math.min(Math.max(melt, 0), 1) * 0.5), h * 0.5);
+    const wickLen = Math.max(rTop * 0.55, h * 0.045);
+    return [Math.cos(leanAngle) * wickLen * 0.72, h - well + wickLen * 0.92, Math.sin(leanAngle) * wickLen * 0.72];
+}

package/dist/components/candle/candleMaterials.d.ts

@@ -0,0 +1,24 @@
+import { MeshBasicMaterial, MeshPhysicalMaterial, ShaderMaterial } from 'three';
+export type FlameMode = 'volumetric' | 'billboard';
+export declare const FLAME_MODES: FlameMode[];
+export interface CandleMaterials {
+    /** Raymarched flame volume. */
+    flame: ShaderMaterial;
+    /** The same field on a camera-facing quad, for crowds of candles. */
+    flameBillboard: ShaderMaterial;
+    /** Smoke wisp after it is snuffed. */
+    smoke: ShaderMaterial;
+    /** The candle body. */
+    wax: MeshPhysicalMaterial;
+    /** The melt pool: wetter, glossier, and it catches the flame above it. */
+    melt: MeshPhysicalMaterial;
+    /** Carbonised wick. */
+    wick: MeshBasicMaterial;
+    /** Glowing wick tip. */
+    ember: MeshBasicMaterial;
+    /** Tight camera-facing wash. */
+    halo: ShaderMaterial;
+}
+export declare function createCandleMaterials(): CandleMaterials;
+export declare function disposeCandleMaterials(m: CandleMaterials): void;
+//# sourceMappingURL=candleMaterials.d.ts.map

package/dist/components/candle/candleMaterials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candleMaterials.d.ts","sourceRoot":"","sources":["../../../src/components/candle/candleMaterials.ts"],"names":[],"mappings":"AAoBA,OAAO,EAC4C,iBAAiB,EAChE,oBAAoB,EAAE,cAAc,EACvC,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AACnD,eAAO,MAAM,WAAW,EAAE,SAAS,EAAgC,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,cAAc,CAAC;IACtB,qEAAqE;IACrE,cAAc,EAAE,cAAc,CAAC;IAC/B,sCAAsC;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,uBAAuB;IACvB,GAAG,EAAE,oBAAoB,CAAC;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,oBAAoB,CAAC;IAC3B,uBAAuB;IACvB,IAAI,EAAE,iBAAiB,CAAC;IACxB,wBAAwB;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,gCAAgC;IAChC,IAAI,EAAE,cAAc,CAAC;CACxB;AAuYD,wBAAgB,qBAAqB,IAAI,eAAe,CAmBvD;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAS/D"}