@pascal-app/viewer 1.0.6 → 1.1.0

package/dist/components/viewer/glb-interactive.d.ts

@@ -1,6 +1,7 @@
 import { type AnyNodeId, type Interactive, type SceneGraph } from '@pascal-app/core';
 import { type EvaluatedLight, type ProceduralItemNode } from '@pascal-app/core/procedural-items';
-import { type AnimationAction, type Object3D, Vector3 } from 'three';
+import { type AnimationAction, type Object3D } from 'three';
+import { type PooledLight } from '../../systems/item-light/pooled-lights';
 /** An interactive item recovered from the scene graph so the baked GLB can be
  *  re-lit / re-animated by joining on `pascalId`. The GLB carries the geometry
  *  + identity; the effects + controls live in the DB scene graph (no sidecar). */
@@ -21,13 +22,6 @@ export type GlbInteractiveItem = {
         recipe?: Pick<ProceduralItemNode['recipe'], 'parts' | 'joints'>;
     };
 };
-/** A baked zone's identity node + its local floor polygon (from `extras`). */
-export type GlbZoneRef = {
-    id: string;
-    node: Object3D;
-    polygon: [number, number][];
-    holes?: [number, number][][];
-};
 /** Pull the interactive items out of a scene graph. Only items that actually
  *  carry effects (light / animation) are returned — everything else baked
  *  faithfully and needs no runtime help. */
@@ -40,24 +34,16 @@ export declare function buildGlbLightRegs(items: GlbInteractiveItem[], identity:
  * baked Object3Ds (`identity`), joined on `pascalId`. Nothing is stamped into
  * the GLB itself, so the artifact stays integrator-clean.
  */
-export declare function GlbInteractive({ items, identity, zones, actions, levelOrder, }: {
+export declare function GlbInteractive({ items, identity, actions, }: {
     items: GlbInteractiveItem[];
     identity: Map<string, Object3D>;
-    zones: GlbZoneRef[];
     /** Baked animation actions keyed by clip name — ambient item loops play from
      *  `<pascalId>: loop`. */
     actions: Record<string, AnimationAction | null>;
-    /** Level pascalIds bottom-to-top, so the light pool can prefer ground-floor
-     *  lights when nothing is focused (mirrors the parametric level factor). */
-    levelOrder: string[];
 }): import("react").JSX.Element;
-export type GlbLightReg = {
-    key: string;
+export type GlbLightReg = PooledLight & {
     nodeId: AnyNodeId;
     object: Object3D;
-    color: string;
-    distance: number;
-    getWorldPosition: (out: Vector3) => void;
     getIntensity: () => number;
     isOn: () => boolean;
     levelId: string | null;

package/dist/components/viewer/glb-interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glb-interactive.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-interactive.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,WAAW,EAGhB,KAAK,UAAU,EAOhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAA;AAI1C,OAAO,EACL,KAAK,eAAe,EAGpB,KAAK,QAAQ,EAEb,OAAO,EACR,MAAM,OAAO,CAAA;AAcd;;kFAEkF;AAClF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,SAAS,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,WAAW,CAAA;IACxB;mEAC+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,+EAA+E;QAC/E,MAAM,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAA;KAChE,CAAA;CACF,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IAC3B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAA;CAC7B,CAAA;AAED;;4CAE4C;AAC5C,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,kBAAkB,EAAE,CAiEtB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC9B,WAAW,EAAE,CAiFf;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,OAAO,EACP,UAAU,GACX,EAAE;IACD,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB;8BAC0B;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC,CAAA;IAC/C;gFAC4E;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB,+BA0FA;AA8CD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,QAAQ,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA"}
+{"version":3,"file":"glb-interactive.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-interactive.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EAEhB,KAAK,UAAU,EAMhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAA;AAG1C,OAAO,EACL,KAAK,eAAe,EAGpB,KAAK,QAAQ,EAGd,MAAM,OAAO,CAAA;AAWd,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,wCAAwC,CAAA;AAEvF;;kFAEkF;AAClF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,SAAS,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,WAAW,CAAA;IACxB;mEAC+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAA;QAC5C,+EAA+E;QAC/E,MAAM,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAA;KAChE,CAAA;CACF,CAAA;AAED;;4CAE4C;AAC5C,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,kBAAkB,EAAE,CAiEtB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC9B,WAAW,EAAE,CA2Ff;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,OAAO,GACR,EAAE;IACD,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC/B;8BAC0B;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC,CAAA;CAChD,+BAuDA;AAsCD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,QAAQ,CAAA;IAChB,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA"}

package/dist/components/viewer/glb-interactive.js

@@ -1,19 +1,17 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { containsPoint, isScriptedNode, scriptedOrigin, scriptedSize, scriptInteractive, useInteractive, } from '@pascal-app/core';
+import { isScriptedNode, scriptedInteractive, scriptedSize, useInteractive, } from '@pascal-app/core';
 import { evaluateRecipe, } from '@pascal-app/core/procedural-items';
-import { Html } from '@react-three/drei';
-import { createPortal, useFrame, useThree } from '@react-three/fiber';
-import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
-import { LoopRepeat, MathUtils, Vector3, } from 'three';
+import { useThree } from '@react-three/fiber';
+import { useEffect, useLayoutEffect, useMemo } from 'react';
+import { LoopRepeat, MathUtils, Quaternion, Vector3, } from 'three';
 import { useShallow } from 'zustand/react/shallow';
 import { SCENE_LAYER } from '../../lib/layers';
 import { decorateProceduralEmission, proceduralSlotMeshes, setProceduralEmission, } from '../../lib/procedural-emission';
 import { useItemLightPool } from '../../store/use-item-light-pool';
 import useViewer from '../../store/use-viewer';
-import { ControlWidget } from '../../systems/interactive/control-widget';
-import { proceduralControlDescriptors } from '../../systems/interactive/procedural-controls';
 import { ScriptedClips } from '../../systems/interactive/scripted-clips';
+import { PooledLights } from '../../systems/item-light/pooled-lights';
 /** Pull the interactive items out of a scene graph. Only items that actually
  *  carry effects (light / animation) are returned — everything else baked
  *  faithfully and needs no runtime help. */
@@ -46,7 +44,7 @@ export function buildGlbInteractiveItems(sceneGraph) {
         // emitted, as in the editor.
         if (isScriptedNode(raw)) {
             const scripted = raw;
-            const interactive = scriptInteractive(scripted.source.manifest, scriptedOrigin(scripted));
+            const interactive = scriptedInteractive(scripted);
             if (!interactive)
                 continue;
             const [, height] = scriptedSize(scripted.source.manifest);
@@ -113,6 +111,7 @@ export function buildGlbLightRegs(items, identity) {
                         const anchor = motion ?? object;
                         anchor.updateWorldMatrix(true, false);
                         out.copy(local).applyMatrix4(anchor.matrixWorld);
+                        return true;
                     },
                     getIntensity: () => light.intensity,
                     isOn: () => useInteractive.getState().procedural[item.pascalId]?.lightsOn ??
@@ -134,6 +133,14 @@ export function buildGlbLightRegs(items, identity) {
                 object,
                 color: effect.color,
                 distance: effect.distance ?? 0,
+                spot: effect.spot,
+                shadows: effect.shadows,
+                glow: effect.glow,
+                peak: effect.intensityRange[1],
+                getWorldDirection: (out) => {
+                    out.set(...(effect.spot?.direction ?? [0, -1, 0])).normalize();
+                    out.applyQuaternion(object.getWorldQuaternion(_quaternion));
+                },
                 getWorldPosition: (out) => {
                     object.updateWorldMatrix(true, false);
                     if (item.scripted) {
@@ -141,10 +148,11 @@ export function buildGlbLightRegs(items, identity) {
                         out
                             .set(effect.offset[0] * scale[0], effect.offset[1] * scale[1], effect.offset[2] * scale[2])
                             .applyMatrix4(object.matrixWorld);
-                        return;
+                        return true;
                     }
                     object.getWorldPosition(out);
                     out.set(out.x + effect.offset[0], out.y + effect.offset[1], out.z + effect.offset[2]);
+                    return true;
                 },
                 getIntensity: () => {
                     const values = useInteractive.getState().items[item.pascalId]?.controlValues;
@@ -162,7 +170,6 @@ export function buildGlbLightRegs(items, identity) {
     }
     return regs;
 }
-const _itemPos = new Vector3();
 /**
  * Re-creates the item-driven interactivity the parametric viewer has — pooled
  * lights, ambient animation, and the controls overlay — on top of a baked GLB.
@@ -170,7 +177,7 @@ const _itemPos = new Vector3();
  * baked Object3Ds (`identity`), joined on `pascalId`. Nothing is stamped into
  * the GLB itself, so the artifact stays integrator-clean.
  */
-export function GlbInteractive({ items, identity, zones, actions, levelOrder, }) {
+export function GlbInteractive({ items, identity, actions, }) {
     const scene = useThree((state) => state.scene);
     useLayoutEffect(() => {
         useItemLightPool.getState().setBakedCanvas(scene, true);
@@ -201,34 +208,11 @@ export function GlbInteractive({ items, identity, zones, actions, levelOrder, })
     }, [items]);
     const animationItems = useMemo(() => items.filter((item) => item.interactive.effects.some((e) => e.kind === 'animation')), [items]);
     const lightRegs = useMemo(() => buildGlbLightRegs(items, identity), [items, identity]);
-    const levelIndexById = useMemo(() => new Map(levelOrder.map((id, i) => [id, i])), [levelOrder]);
-    // Project the zone's baked-local polygon into world space so focused zone
-    // membership still works after level stacking moves its parent.
-    const focusedZoneId = useViewer((s) => s.selection.zoneId);
-    const selectedIds = useViewer((s) => s.selection.selectedIds);
-    const worldPolygon = useMemo(() => {
-        if (!focusedZoneId)
-            return null;
-        const zone = zones.find((z) => z.id === focusedZoneId);
-        if (!zone)
-            return null;
-        zone.node.updateWorldMatrix(true, false);
-        const project = (ring) => ring.map(([x, z]) => {
-            const v = new Vector3(x, 0, z).applyMatrix4(zone.node.matrixWorld);
-            return [v.x, v.z];
-        });
-        return { outer: project(zone.polygon), holes: (zone.holes ?? []).map(project) };
-    }, [focusedZoneId, zones]);
-    return (_jsxs(_Fragment, { children: [_jsx(GlbItemLights, { levelIndexById: levelIndexById, regs: lightRegs }), animationItems.map((item) => item.scripted ? (_jsx(GlbScriptedClips, { actions: actions, item: item }, item.pascalId)) : (_jsx(GlbItemAnimation, { actions: actions, item: item }, item.pascalId))), items
+    return (_jsxs(_Fragment, { children: [_jsx(GlbItemLights, { regs: lightRegs }), animationItems.map((item) => item.scripted ? (_jsx(GlbScriptedClips, { actions: actions, item: item }, item.pascalId)) : (_jsx(GlbItemAnimation, { actions: actions, item: item }, item.pascalId))), items
                 .filter((item) => item.procedural?.lights.length)
                 .map((item) => {
                 const object = identity.get(item.pascalId);
                 return object ? (_jsx(GlbProceduralEmission, { item: item, object: object }, item.pascalId)) : null;
-            }), items
-                .filter((item) => worldPolygon || selectedIds.includes(item.pascalId))
-                .map((item) => {
-                const object = identity.get(item.pascalId);
-                return object ? (_jsx(GlbItemControls, { isSelected: selectedIds.includes(item.pascalId), item: item, object: object, worldPolygon: worldPolygon }, item.pascalId)) : null;
             })] }));
 }
 function GlbProceduralEmission({ item, object }) {
@@ -258,22 +242,7 @@ function GlbProceduralEmission({ item, object }) {
     }, [item, object]);
     return null;
 }
-// ── Pooled item lights ──────────────────────────────────────────────────────
-//
-// Mirrors the parametric `ItemLightSystem`: a fixed pool of point lights is
-// assigned to the nearest/most-visible lit items each tick (camera-proximity
-// scored, with hysteresis), snapped to the item's world position + offset, and
-// faded in/out on reassignment. Mounting a light per item instead would blow
-// the renderer's light budget on a large house.
-const POOL_SIZE = 12;
-const REASSIGN_INTERVAL = 0.2;
-const HYSTERESIS = 0.15;
-const CAM_MOVE_DIST = 0.5;
-const CAM_ROT_DOT = 0.995;
-const _camPos = new Vector3();
-const _camFwd = new Vector3();
-const _dir = new Vector3();
-const _lightWorld = new Vector3();
+const _quaternion = new Quaternion();
 /** The nearest level-identity ancestor's pascalId, for the level factor. */
 function findLevelId(object) {
     let cur = object;
@@ -294,168 +263,21 @@ function isRendered(object) {
     }
     return true;
 }
-function scoreReg(reg, selectedLevelId, levelMode, levelIndexById) {
+// A light on another storey than the focused one counts for this much of what it adds.
+const OTHER_LEVEL_WEIGHT = 0.25;
+/** 0 while the light cannot be seen lit (off, hidden, on a hidden level), else its level factor. */
+function regWeight(reg, selectedLevelId, levelMode) {
     if (!reg.isOn() || !isRendered(reg.object))
-        return Number.POSITIVE_INFINITY;
-    if (selectedLevelId && reg.levelId !== selectedLevelId && levelMode === 'solo')
-        return Number.POSITIVE_INFINITY;
-    reg.getWorldPosition(_lightWorld);
-    _dir.copy(_lightWorld).sub(_camPos).normalize();
-    const angular = 1 - _camFwd.dot(_dir);
-    const dist = _camPos.distanceTo(_lightWorld) / 200;
-    let levelPenalty = 0;
-    if (selectedLevelId) {
-        if (reg.levelId !== selectedLevelId)
-            levelPenalty = levelMode === 'solo' ? 100 : 0.8;
-    }
-    else if (reg.levelId && (levelIndexById.get(reg.levelId) ?? 0) !== 0) {
-        levelPenalty = 0.3;
-    }
-    return angular * 0.7 + dist * 0.3 + levelPenalty;
+        return 0;
+    if (!selectedLevelId || reg.levelId === selectedLevelId)
+        return 1;
+    return levelMode === 'solo' ? 0 : OTHER_LEVEL_WEIGHT;
 }
-function GlbItemLights({ regs, levelIndexById, }) {
-    const lightRefs = useRef(Array.from({ length: POOL_SIZE }, () => null));
-    const slots = useRef(Array.from({ length: POOL_SIZE }, () => ({ key: null, pendingKey: null, isFadingOut: false })));
-    const reassignTimer = useRef(0);
-    const prevCamPos = useRef(new Vector3());
-    const prevCamFwd = useRef(new Vector3(0, 0, -1));
-    const regByKey = useMemo(() => new Map(regs.map((r) => [r.key, r])), [regs]);
-    useFrame(({ camera }, delta) => {
-        const dt = Math.min(delta, 0.1);
-        camera.getWorldPosition(_camPos);
-        camera.getWorldDirection(_camFwd);
-        const camMoved = _camPos.distanceTo(prevCamPos.current) > CAM_MOVE_DIST ||
-            _camFwd.dot(prevCamFwd.current) < CAM_ROT_DOT;
-        reassignTimer.current -= delta;
-        if (reassignTimer.current <= 0 || camMoved) {
-            reassignTimer.current = REASSIGN_INTERVAL;
-            prevCamPos.current.copy(_camPos);
-            prevCamFwd.current.copy(_camFwd);
+function GlbItemLights({ regs }) {
+    return (_jsx(PooledLights, { getLights: () => regs, intensity: (reg) => (reg.isOn() && isRendered(reg.object) ? reg.getIntensity() : 0), weight: (reg) => {
             const viewer = useViewer.getState();
-            const selectedLevelId = viewer.selection.levelId;
-            const levelMode = viewer.levelMode;
-            const scored = regs.map((reg) => ({
-                key: reg.key,
-                score: scoreReg(reg, selectedLevelId, levelMode, levelIndexById),
-            }));
-            scored.sort((a, b) => a.score - b.score);
-            const scoreByKey = new Map(scored.map((s) => [s.key, s.score]));
-            const desired = scored
-                .filter((s) => Number.isFinite(s.score))
-                .slice(0, POOL_SIZE)
-                .map((s) => s.key);
-            const currentlyAssigned = new Map();
-            for (let i = 0; i < POOL_SIZE; i++) {
-                const s = slots.current[i];
-                const k = s?.key ?? s?.pendingKey;
-                if (k)
-                    currentlyAssigned.set(k, i);
-            }
-            const usedSlots = new Set();
-            const assignedKeys = new Set();
-            // Pass 1: keep existing slots whose key is still wanted.
-            for (const key of desired) {
-                const existingSlot = currentlyAssigned.get(key);
-                if (existingSlot !== undefined && !usedSlots.has(existingSlot)) {
-                    usedSlots.add(existingSlot);
-                    assignedKeys.add(key);
-                }
-            }
-            // Pass 2: assign the rest to free slots, evicting only on a clear win.
-            let freeSlot = 0;
-            for (const key of desired) {
-                if (assignedKeys.has(key))
-                    continue;
-                while (freeSlot < POOL_SIZE && usedSlots.has(freeSlot))
-                    freeSlot++;
-                if (freeSlot >= POOL_SIZE)
-                    break;
-                const freeSlotData = slots.current[freeSlot];
-                const currentKey = freeSlotData ? (freeSlotData.key ?? freeSlotData.pendingKey) : null;
-                if (currentKey && !desired.includes(currentKey)) {
-                    const currentScore = scoreByKey.get(currentKey) ?? Number.POSITIVE_INFINITY;
-                    const newScore = scoreByKey.get(key) ?? 0;
-                    if (currentScore - newScore < HYSTERESIS) {
-                        freeSlot++;
-                        continue;
-                    }
-                }
-                usedSlots.add(freeSlot);
-                assignedKeys.add(key);
-                const slot = slots.current[freeSlot];
-                if (slot && slot.key !== key) {
-                    slot.pendingKey = key;
-                    slot.isFadingOut = slot.key !== null;
-                    if (!slot.isFadingOut) {
-                        slot.key = key;
-                        slot.pendingKey = null;
-                        const light = lightRefs.current[freeSlot];
-                        const reg = regByKey.get(key);
-                        if (light && reg) {
-                            light.color.set(reg.color);
-                            light.distance = reg.distance;
-                        }
-                    }
-                }
-                freeSlot++;
-            }
-            // Retire slots whose key is no longer wanted.
-            for (let i = 0; i < POOL_SIZE; i++) {
-                if (!usedSlots.has(i)) {
-                    const slot = slots.current[i];
-                    if (slot?.key && !desired.includes(slot.key)) {
-                        slot.pendingKey = null;
-                        slot.isFadingOut = true;
-                    }
-                }
-            }
-        }
-        // Per-frame: fade, snap position, and track intensity from control state.
-        // The pool lights stay permanently `visible` — only `intensity` is animated
-        // (an idle light just lerps to 0). Toggling `visible` would change the
-        // active-light count, which forces the WebGPU renderer to recompile every
-        // material's lighting node — a hard frame-time spike on every reassignment
-        // (i.e. on every camera move). Keeping the count fixed avoids that entirely.
-        for (let i = 0; i < POOL_SIZE; i++) {
-            const light = lightRefs.current[i];
-            const slot = slots.current[i];
-            if (!(light && slot))
-                continue;
-            if (slot.isFadingOut) {
-                light.intensity = MathUtils.lerp(light.intensity, 0, dt * 12);
-                if (light.intensity < 0.01) {
-                    light.intensity = 0;
-                    slot.isFadingOut = false;
-                    slot.key = slot.pendingKey;
-                    slot.pendingKey = null;
-                    if (slot.key) {
-                        const reg = regByKey.get(slot.key);
-                        if (reg) {
-                            light.color.set(reg.color);
-                            light.distance = reg.distance;
-                        }
-                    }
-                }
-                continue;
-            }
-            if (!slot.key) {
-                light.intensity = MathUtils.lerp(light.intensity, 0, dt * 12);
-                continue;
-            }
-            const reg = regByKey.get(slot.key);
-            if (!reg) {
-                slot.key = null;
-                continue;
-            }
-            reg.getWorldPosition(_lightWorld);
-            light.position.copy(_lightWorld);
-            const targetIntensity = reg.isOn() && isRendered(reg.object) ? reg.getIntensity() : 0;
-            light.intensity = MathUtils.lerp(light.intensity, targetIntensity, dt * 12);
-        }
-    }, 6);
-    return (_jsx(_Fragment, { children: Array.from({ length: POOL_SIZE }, (_, i) => (_jsx("pointLight", { castShadow: false, intensity: 0, ref: (el) => {
-                lightRefs.current[i] = el;
-            } }, i))) }));
+            return regWeight(reg, viewer.selection.levelId, viewer.levelMode);
+        } }));
 }
 /** Plays an item's baked ambient loop (a fan's spin), gated on its toggle.
  *  The clip and its targets are already in the GLB; we only start/stop it. */
@@ -501,61 +323,3 @@ function GlbScriptedClips({ item, actions, }) {
     }, [actions, item.pascalId]);
     return (_jsx(ScriptedClips, { actions: scriptActions, interactive: item.interactive, nodeId: item.pascalId }));
 }
-const FADE_MS = 300;
-/** Controls overlay for a selected item or one inside the focused zone. */
-function GlbItemControls({ item, object, worldPolygon, isSelected, }) {
-    const controlValues = useInteractive(useShallow((s) => s.items[item.pascalId]?.controlValues));
-    const proceduralState = useInteractive((s) => s.procedural[item.pascalId]);
-    const lampDefault = useInteractive((s) => s.lampDefault);
-    const setControlValue = useInteractive((s) => s.setControlValue);
-    const togglePart = useInteractive((s) => s.toggleProceduralPart);
-    const toggleLights = useInteractive((s) => s.toggleProceduralLights);
-    const descriptors = item.procedural
-        ? proceduralControlDescriptors(item.procedural.recipe ?? { parts: item.procedural.parts }, proceduralState, (partId) => togglePart(item.pascalId, partId), () => toggleLights(item.pascalId), lampDefault)
-        : item.interactive.controls.map((control, index) => ({
-            key: String(index),
-            control,
-            value: controlValues?.[index] ?? false,
-            onChange: (value) => setControlValue(item.pascalId, index, value),
-        }));
-    let visible = isSelected;
-    if (worldPolygon) {
-        object.getWorldPosition(_itemPos);
-        visible = visible || containsPoint([worldPolygon], [_itemPos.x, _itemPos.z]);
-    }
-    // Fade in on mount and fade out before unmounting the <Html>.
-    const [mounted, setMounted] = useState(false);
-    const [shown, setShown] = useState(false);
-    useEffect(() => {
-        if (visible) {
-            setMounted(true);
-            let raf2 = 0;
-            const raf1 = requestAnimationFrame(() => {
-                raf2 = requestAnimationFrame(() => setShown(true));
-            });
-            return () => {
-                cancelAnimationFrame(raf1);
-                cancelAnimationFrame(raf2);
-            };
-        }
-        setShown(false);
-        const timeout = setTimeout(() => setMounted(false), FADE_MS);
-        return () => clearTimeout(timeout);
-    }, [visible]);
-    if (!(mounted && descriptors.length))
-        return null;
-    return createPortal(_jsx(Html, { center: true, distanceFactor: 8, eps: -1, position: [0, item.height + 0.3, 0], zIndexRange: [20, 0], children: _jsx("div", { onClick: (e) => e.stopPropagation(), onPointerDown: (e) => e.stopPropagation(), onPointerUp: (e) => e.stopPropagation(), style: {
-                display: 'flex',
-                flexDirection: 'column',
-                gap: 6,
-                background: 'rgba(0,0,0,0.75)',
-                backdropFilter: 'blur(8px)',
-                borderRadius: 8,
-                padding: '8px 12px',
-                minWidth: 120,
-                pointerEvents: visible ? 'auto' : 'none',
-                userSelect: 'none',
-                opacity: shown ? 1 : 0,
-                transition: `opacity ${FADE_MS}ms ease`,
-            }, children: descriptors.map((descriptor) => (_jsx(ControlWidget, { control: descriptor.control, onChange: descriptor.onChange, value: descriptor.value }, descriptor.key))) }) }), object);
-}

package/dist/components/viewer/glb-replace-instances.d.ts

@@ -1,4 +1,4 @@
-import { type AnyNode } from '@pascal-app/core';
+import { type AnyNode, type GeometryContext } from '@pascal-app/core';
 import type { Object3D } from 'three';
 /**
  * Re-renders `bake: 'replace'` kinds (e.g. plugin trees) live over the baked GLB.
@@ -9,10 +9,13 @@ import type { Object3D } from 'three';
  * free, and a forest stays a few instanced draw calls.
  *
  * Memoized: `GlbScene` re-renders each frame on camera move; `nodes` and
- * `identity` are stable refs, so this whole subtree short-circuits.
+ * `identity` are stable refs, so this whole subtree short-circuits; `resolve`
+ * must be stable too.
  */
-export declare const GlbReplaceInstances: import("react").MemoExoticComponent<({ nodes, identity, }: {
+export declare const GlbReplaceInstances: import("react").MemoExoticComponent<({ nodes, identity, resolve, }: {
     nodes: AnyNode[];
     identity: Map<string, Object3D>;
+    /** Looks up nodes of the published scene graph; handed to every renderer. */
+    resolve?: GeometryContext['resolve'];
 }) => import("react").JSX.Element>;
 //# sourceMappingURL=glb-replace-instances.d.ts.map

package/dist/components/viewer/glb-replace-instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glb-replace-instances.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-replace-instances.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAA0C,MAAM,kBAAkB,CAAA;AAGvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAerC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,6DAG7B;IACD,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAChC,iCAyCC,CAAA"}
+{"version":3,"file":"glb-replace-instances.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-replace-instances.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,eAAe,EAErB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAiBrC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,sEAI7B;IACD,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC/B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;CACrC,iCAyCC,CAAA"}

package/dist/components/viewer/glb-replace-instances.js

@@ -1,6 +1,6 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { nodeRegistry } from '@pascal-app/core';
+import { nodeRegistry, } from '@pascal-app/core';
 import { createPortal } from '@react-three/fiber';
 import { Fragment, lazy, memo, Suspense, useMemo } from 'react';
 // Lazy components cached by their source so React.lazy isn't re-invoked per render.
@@ -22,9 +22,10 @@ function getReplaceRenderer(source) {
  * free, and a forest stays a few instanced draw calls.
  *
  * Memoized: `GlbScene` re-renders each frame on camera move; `nodes` and
- * `identity` are stable refs, so this whole subtree short-circuits.
+ * `identity` are stable refs, so this whole subtree short-circuits; `resolve`
+ * must be stable too.
  */
-export const GlbReplaceInstances = memo(function GlbReplaceInstances({ nodes, identity, }) {
+export const GlbReplaceInstances = memo(function GlbReplaceInstances({ nodes, identity, resolve, }) {
     const byLevel = useMemo(() => {
         const levels = new Map();
         for (const node of nodes) {
@@ -54,7 +55,7 @@ export const GlbReplaceInstances = memo(function GlbReplaceInstances({ nodes, id
             if (!source)
                 return;
             const Renderer = getReplaceRenderer(source);
-            portals.push(_jsx(Fragment, { children: createPortal(_jsx(Suspense, { fallback: null, children: _jsx(Renderer, { nodes: kindNodes }) }), anchor) }, `${parentId}:${kind}`));
+            portals.push(_jsx(Fragment, { children: createPortal(_jsx(Suspense, { fallback: null, children: _jsx(Renderer, { nodes: kindNodes, resolve: resolve }) }), anchor) }, `${parentId}:${kind}`));
         });
     });
     return _jsx(_Fragment, { children: portals });

package/dist/components/viewer/glb-scene-motion.d.ts

@@ -0,0 +1,8 @@
+import { type AnimationAction, type Object3D } from 'three';
+import type { ScriptedClipActions } from '../../systems/interactive/scripted-clips';
+export declare function isGlbShutterHit(hit: Object3D, identity: Object3D): boolean;
+export declare function playGlbShutters(action: AnimationAction, open: boolean): void;
+/** Own only the shutters part; the sash and other mechanisms keep their own state. */
+export declare function bindGlbShutters(identity: ReadonlyMap<string, Object3D>, actions: ScriptedClipActions): () => void;
+export declare function toggleGlbShutters(node: Object3D): boolean;
+//# sourceMappingURL=glb-scene-motion.d.ts.map

package/dist/components/viewer/glb-scene-motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glb-scene-motion.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-scene-motion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAY,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAEnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAK1E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAO5E;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvC,OAAO,EAAE,mBAAmB,GAC3B,MAAM,IAAI,CAgCZ;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAMzD"}

package/dist/components/viewer/glb-scene-motion.js

@@ -0,0 +1,57 @@
+import { useInteractive } from '@pascal-app/core';
+import { LoopOnce } from 'three';
+export function isGlbShutterHit(hit, identity) {
+    for (let part = hit; part && part !== identity; part = part.parent) {
+        if (part.name.startsWith('shutter-') || part.name.startsWith('window-roller-'))
+            return true;
+    }
+    return false;
+}
+export function playGlbShutters(action, open) {
+    action.enabled = true;
+    action.paused = false;
+    action.setLoop(LoopOnce, 1);
+    action.clampWhenFinished = true;
+    action.timeScale = open ? 1 : -1;
+    action.play();
+}
+/** Own only the shutters part; the sash and other mechanisms keep their own state. */
+export function bindGlbShutters(identity, actions) {
+    const parts = new Map();
+    for (const [id, object] of identity) {
+        const extras = object.userData;
+        const name = extras.clips?.find((clip) => clip === `${id}: shutters`);
+        const action = name ? actions[name] : undefined;
+        if (!extras.shutters || !action)
+            continue;
+        const fraction = Math.max(0, Math.min(1, extras.shuttersOpen ?? 1));
+        action.time = fraction * action.getClip().duration;
+        // Keep the baked rest pose until the first toggle, including separately saved roller poses.
+        parts.set(id, action);
+        useInteractive.getState().setMechanismPart(id, 'shutters', fraction > 0.5);
+    }
+    const unsubscribe = useInteractive.subscribe((state, previous) => {
+        if (state.mechanismParts === previous.mechanismParts)
+            return;
+        for (const [id, action] of parts) {
+            const key = `${id}:shutters`;
+            if (state.mechanismParts[key] !== previous.mechanismParts[key])
+                playGlbShutters(action, Boolean(state.mechanismParts[key]));
+        }
+    });
+    return () => {
+        unsubscribe();
+        for (const [id, action] of parts) {
+            action.stop();
+            useInteractive.getState().removeMechanismPart(id, 'shutters');
+        }
+    };
+}
+export function toggleGlbShutters(node) {
+    const { shutters, pascalId } = node.userData;
+    if (!shutters || !pascalId)
+        return false;
+    const state = useInteractive.getState();
+    state.setMechanismPart(pascalId, 'shutters', !state.mechanismParts[`${pascalId}:shutters`]);
+    return true;
+}

package/dist/components/viewer/glb-scene.d.ts

@@ -51,7 +51,7 @@ export declare function resolveGlbPick(hits: readonly HitCandidate[], identity:
  * when clicked. The host disables the parametric `SelectionManager`
  * (`selectionManager="custom"`).
  */
-export declare function GlbScene({ url, interactiveItems, referenceNodes, replaceNodes, onObjectsChange, onPick, onWalkthroughChange, }: {
+export declare function GlbScene({ url, interactiveItems, referenceNodes, replaceNodes, onObjectsChange, onPick, onWalkthroughChange, sceneNodes, }: {
     url: string;
     /** Light / animation effects + controls recovered from the DB scene graph,
      *  joined to the baked nodes by `pascalId` to re-light + re-animate the GLB. */
@@ -67,6 +67,10 @@ export declare function GlbScene({ url, interactiveItems, referenceNodes, replac
     /** Clicks and hovers on the building; without it the scene is look-only. */
     onPick?: (event: GlbPickEvent) => void;
     onWalkthroughChange?: (state: GlbWalkthrough) => void;
+    /** Every node of the scene graph the artifact was baked from: the selection
+     *  callout says what each element is, and `replace` renderers resolve their
+     *  parent and siblings. A stable reference. */
+    sceneNodes?: Readonly<Record<string, AnyNode>>;
 }): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=glb-scene.d.ts.map

package/dist/components/viewer/glb-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glb-scene.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-scene.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAYb,MAAM,kBAAkB,CAAA;AAQzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAmB3E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/D,SAAS,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAC1E,CAAA;AAKD;0EAC0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/D,GAAG,IAAI,CAAA;AAoDR,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,CAAA;AA0CpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAC5C,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CAkB5E;AASD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAG,EACH,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,MAAM,EACN,mBAAmB,GACpB,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX;oFACgF;IAChF,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACvC;mFAC+E;IAC/E,cAAc,CAAC,EAAE,OAAO,EAAE,CAAA;IAC1B;kFAC8E;IAC9E,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;IACxB,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAA;IACxE,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACtC,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;CACtD,+BA8xBA"}
+{"version":3,"file":"glb-scene.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-scene.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAcb,MAAM,kBAAkB,CAAA;AASzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAoB9B,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAuB3E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IAC/D,SAAS,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAC1E,CAAA;AAKD;0EAC0E;AAC1E,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/D,GAAG,IAAI,CAAA;AAqDR,KAAK,YAAY,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,CAAA;AA4CpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAC5C,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CAkB5E;AASD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAG,EACH,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,MAAM,EACN,mBAAmB,EACnB,UAAU,GACX,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX;oFACgF;IAChF,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACvC;mFAC+E;IAC/E,cAAc,CAAC,EAAE,OAAO,EAAE,CAAA;IAC1B;kFAC8E;IAC9E,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;IACxB,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAA;IACxE,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACtC,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACrD;;mDAE+C;IAC/C,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC/C,+BA47BA"}