lunchboxjs 0.2.1001-beta.0 → 0.2.1001-beta.1

package/dist/lunchboxjs.js

@@ -141,6 +141,7 @@
     const appRenderersKey = Symbol();
     const appSceneKey = Symbol();
     const appCameraKey = Symbol();
+    const lunchboxInteractables = Symbol();
     const startCallbackKey = Symbol();
 
     const ensuredCamera = () => vue.inject(appCameraKey); // ENSURE RENDERER
@@ -151,215 +152,11 @@
 
     const ensuredScene = () => vue.inject(appSceneKey);
 
-    const interactables = [];
-    const addInteractable = target => {
-      interactables.push(target);
-    };
-    const removeInteractable = target => {
-      const idx = interactables.indexOf(target);
-
-      if (idx !== -1) {
-        interactables.splice(idx, 1);
-      }
-    };
-
-    /** Mouse is down, touch is pressed, etc */
-
-    const inputActive = vue.ref(false);
-
-    // let mouseDownListener: (event: MouseEvent) => void
-    // let mouseUpListener: (event: MouseEvent) => void
-
-    const mousePos = vue.ref({
-      x: Infinity,
-      y: Infinity
-    }); // let autoRaycasterEventsInitialized = false
-    // let frameID: number
-    // export const setupAutoRaycaster = (node: Lunch.Node<THREE.Raycaster>) => {
-    //     const instance = node.instance
-    //     if (!instance) return
-    //     // TODO: inject doesn't work here. replace this raycaster with a component so we can
-    //     // `inject` in `setup`?
-    //     const appLevelGlobals = { dpr: window.devicePixelRatio } //useGlobals()
-    //     // add mouse events once renderer is ready
-    //     let stopWatcher: WatchStopHandle | null = null
-    //     stopWatcher = watch(
-    //         () => ensureRenderer.value,
-    //         (renderer) => {
-    //             // make sure renderer exists
-    //             if (!renderer?.instance) return
-    //             // cancel early if autoraycaster exists
-    //             if (autoRaycasterEventsInitialized) {
-    //                 if (stopWatcher) stopWatcher()
-    //                 return
-    //             }
-    //             // create mouse events
-    //             mouseMoveListener = (evt) => {
-    //                 const screenWidth =
-    //                     (renderer.instance!.domElement.width ?? 1) /
-    //                     appLevelGlobals.dpr
-    //                 const screenHeight =
-    //                     (renderer.instance!.domElement.height ?? 1) /
-    //                     appLevelGlobals.dpr
-    //                 mousePos.value.x = (evt.offsetX / screenWidth) * 2 - 1
-    //                 mousePos.value.y = -(evt.offsetY / screenHeight) * 2 + 1
-    //             }
-    //             mouseDownListener = () => (inputActive.value = true)
-    //             mouseUpListener = () => (inputActive.value = false)
-    //             // add mouse events
-    //             renderer.instance.domElement.addEventListener(
-    //                 'mousemove',
-    //                 mouseMoveListener
-    //             )
-    //             renderer.instance.domElement.addEventListener(
-    //                 'mousedown',
-    //                 mouseDownListener
-    //             )
-    //             renderer.instance.domElement.addEventListener(
-    //                 'mouseup',
-    //                 mouseUpListener
-    //             )
-    //             // TODO: add touch events
-    //             // process mouse events asynchronously, whenever the mouse state changes
-    //             watch(
-    //                 () => [inputActive.value, mousePos.value.x, mousePos.value.y],
-    //                 () => {
-    //                     if (frameID) cancelAnimationFrame(frameID)
-    //                     frameID = requestAnimationFrame(() => {
-    //                         autoRaycasterBeforeRender()
-    //                     })
-    //                 }
-    //             )
-    //             // mark complete
-    //             autoRaycasterEventsInitialized = true
-    //             // cancel setup watcher
-    //             if (stopWatcher) {
-    //                 stopWatcher()
-    //             }
-    //         },
-    //         { immediate: true }
-    //     )
-    // }
-    // AUTO-RAYCASTER CALLBACK
-    // ====================
-
-    let currentIntersections = []; // const autoRaycasterBeforeRender = () => {
-    //     // setup
-    //     const raycaster = ensuredRaycaster.value?.instance
-    //     const camera = ensuredCamera.value?.instance
-    //     if (!raycaster || !camera) return
-    //     raycaster.setFromCamera(globals.mousePos.value, camera)
-    //     const intersections = raycaster.intersectObjects(
-    //         interactables.map((v) => v.instance as any as THREE.Object3D)
-    //     )
-    //     let enterValues: Array<Intersection<THREE.Object3D>> = [],
-    //         sameValues: Array<Intersection<THREE.Object3D>> = [],
-    //         leaveValues: Array<Intersection<THREE.Object3D>> = [],
-    //         entering: Array<{
-    //             element: Lunch.Node
-    //             intersection: Intersection<THREE.Object3D>
-    //         }> = [],
-    //         staying: Array<{
-    //             element: Lunch.Node
-    //             intersection: Intersection<THREE.Object3D>
-    //         }> = []
-    //     // intersection arrays
-    //     leaveValues = currentIntersections.map((v) => v.intersection)
-    //     // element arrays
-    //     intersections?.forEach((intersection) => {
-    //         const currentIdx = currentIntersections.findIndex(
-    //             (v) => v.intersection.object === intersection.object
-    //         )
-    //         if (currentIdx === -1) {
-    //             // new intersection
-    //             enterValues.push(intersection)
-    //             const found = interactables.find(
-    //                 (v) => v.instance?.uuid === intersection.object.uuid
-    //             )
-    //             if (found) {
-    //                 entering.push({ element: found, intersection })
-    //             }
-    //         } else {
-    //             // existing intersection
-    //             sameValues.push(intersection)
-    //             const found = interactables.find(
-    //                 (v) => v.instance?.uuid === intersection.object.uuid
-    //             )
-    //             if (found) {
-    //                 staying.push({ element: found, intersection })
-    //             }
-    //         }
-    //         // this is a current intersection, so it won't be in our `leave` array
-    //         const leaveIdx = leaveValues.findIndex(
-    //             (v) => v.object.uuid === intersection.object.uuid
-    //         )
-    //         if (leaveIdx !== -1) {
-    //             leaveValues.splice(leaveIdx, 1)
-    //         }
-    //     })
-    //     const leaving: Array<{
-    //         element: Lunch.Node
-    //         intersection: Intersection<THREE.Object3D>
-    //     }> = leaveValues.map((intersection) => {
-    //         return {
-    //             element: interactables.find(
-    //                 (interactable) =>
-    //                     interactable.instance?.uuid === intersection.object.uuid
-    //             ) as any as Lunch.Node,
-    //             intersection,
-    //         }
-    //     })
-    //     // new interactions
-    //     entering.forEach(({ element, intersection }) => {
-    //         fireEventsFromIntersections({
-    //             element,
-    //             eventKeys: ['onPointerEnter'],
-    //             intersection,
-    //         })
-    //     })
-    //     // unchanged interactions
-    //     staying.forEach(({ element, intersection }) => {
-    //         const eventKeys: Array<Lunch.EventKey> = [
-    //             'onPointerOver',
-    //             'onPointerMove',
-    //         ]
-    //         fireEventsFromIntersections({ element, eventKeys, intersection })
-    //     })
-    //     // exited interactions
-    //     leaving.forEach(({ element, intersection }) => {
-    //         const eventKeys: Array<Lunch.EventKey> = [
-    //             'onPointerLeave',
-    //             'onPointerOut',
-    //         ]
-    //         fireEventsFromIntersections({ element, eventKeys, intersection })
-    //     })
-    //     currentIntersections = ([] as any).concat(entering, staying)
-    // }
-    // utility function for firing multiple callbacks and multiple events on a Lunchbox.Element
-    // const fireEventsFromIntersections = ({
-    //     element,
-    //     eventKeys,
-    //     intersection,
-    // }: {
-    //     element: Lunch.Node
-    //     eventKeys: Array<Lunch.EventKey>
-    //     intersection: Intersection<THREE.Object3D>
-    // }) => {
-    //     if (!element) return
-    //     eventKeys.forEach((eventKey) => {
-    //         if (element.eventListeners[eventKey]) {
-    //             element.eventListeners[eventKey].forEach((cb) => {
-    //                 cb({ intersection })
-    //             })
-    //         }
-    //     })
-    // }
-
     /** Add an event listener to the given node. Also creates the event teardown function and any necessary raycaster/interaction dictionary updates. */
-
     function addEventListener({
       node,
       key,
+      interactables,
       value
     }) {
       // create new records for this key if needed
@@ -375,37 +172,18 @@
       node.eventListeners[key].push(value); // if we need it, let's get/create the main raycaster
 
       if (interactionsRequiringRaycaster.includes(key)) {
-        // we're not using `v` here, we're just making sure the raycaster has been created
-        // TODO: is this necessary?
-        // const v = ensuredRaycaster.value
-        if (node.instance && !interactables.includes(node)) {
-          addInteractable(node);
-          node.eventListenerRemoveFunctions[key].push(() => removeInteractable(node));
-        }
-      } // register click, pointerdown, pointerup
-
-
-      if (key === 'onClick' || key === 'onPointerDown' || key === 'onPointerUp') {
-        const stop = vue.watch(() => inputActive.value, isDown => {
-          const idx = currentIntersections.map(v => v.element).findIndex(v => v.instance && v.instance.uuid === node.instance?.uuid);
-
-          if (idx !== -1) {
-            if (isDown && (key === 'onClick' || key === 'onPointerDown')) {
-              node.eventListeners[key].forEach(func => {
-                func({
-                  intersection: currentIntersections[idx].intersection
-                });
-              });
-            } else if (!isDown && key === 'onPointerUp') {
-              node.eventListeners[key].forEach(func => {
-                func({
-                  intersection: currentIntersections[idx].intersection
-                });
-              });
+        if (node.instance && !interactables.value.includes(node)) {
+          // add to interactables
+          interactables.value.push(node);
+          node.eventListenerRemoveFunctions[key].push(() => {
+            // remove from interactables
+            const idx = interactables.value.indexOf(node);
+
+            if (idx !== -1) {
+              interactables.value.splice(idx, 1);
             }
-          }
-        });
-        node.eventListenerRemoveFunctions[key].push(stop);
+          });
+        }
       }
 
       return node;
@@ -499,6 +277,195 @@
 
     });
 
+    const LunchboxEventHandlers = vue.defineComponent({
+      name: 'LunchboxEventHandlers',
+
+      setup() {
+        const interactables = useLunchboxInteractables();
+        const camera = useCamera();
+        const renderer = useRenderer();
+        const globals = useGlobals();
+        const mousePos = vue.ref({
+          x: Infinity,
+          y: Infinity
+        });
+        const inputActive = vue.ref(false);
+        let currentIntersections = [];
+        const raycaster = new THREE__namespace.Raycaster(new THREE__namespace.Vector3(), new THREE__namespace.Vector3(0, 0, -1));
+
+        const fireEventsFromIntersections = ({
+          element,
+          eventKeys,
+          intersection
+        }) => {
+          if (!element) return;
+          eventKeys.forEach(eventKey => {
+            if (element.eventListeners[eventKey]) {
+              element.eventListeners[eventKey].forEach(cb => {
+                cb({
+                  intersection
+                });
+              });
+            }
+          });
+        }; // add mouse listener to renderer DOM element when the element is ready
+
+
+        const stopWatch = vue.watch(renderer, v => {
+          if (!v?.domElement) return; // we have a DOM element, so let's add mouse listeners
+
+          const {
+            domElement
+          } = v;
+
+          const mouseMoveListener = evt => {
+            const screenWidth = (domElement.width ?? 1) / globals.dpr;
+            const screenHeight = (domElement.height ?? 1) / globals.dpr;
+            mousePos.value.x = evt.offsetX / screenWidth * 2 - 1;
+            mousePos.value.y = -(evt.offsetY / screenHeight) * 2 + 1;
+          };
+
+          const mouseDownListener = () => inputActive.value = true;
+
+          const mouseUpListener = () => inputActive.value = false; // add mouse events
+
+
+          domElement.addEventListener('pointermove', mouseMoveListener);
+          domElement.addEventListener('pointerdown', mouseDownListener);
+          domElement.addEventListener('pointerup', mouseUpListener); // stop the watcher
+
+          stopWatch();
+        }, {
+          immediate: true
+        });
+
+        const update = () => {
+          const c = camera.value;
+          if (!c) return;
+          raycaster.setFromCamera(mousePos.value, c);
+          const intersections = raycaster.intersectObjects(interactables?.value.map(v => v.instance) ?? []);
+          let leaveValues = [],
+              entering = [],
+              staying = []; // intersection arrays
+
+          leaveValues = currentIntersections.map(v => v.intersection); // element arrays
+
+          intersections?.forEach(intersection => {
+            const currentIdx = currentIntersections.findIndex(v => v.intersection.object === intersection.object);
+
+            if (currentIdx === -1) {
+              const found = interactables?.value.find(v => v.instance?.uuid === intersection.object.uuid);
+
+              if (found) {
+                entering.push({
+                  element: found,
+                  intersection
+                });
+              }
+            } else {
+              const found = interactables?.value.find(v => v.instance?.uuid === intersection.object.uuid);
+
+              if (found) {
+                staying.push({
+                  element: found,
+                  intersection
+                });
+              }
+            } // this is a current intersection, so it won't be in our `leave` array
+
+
+            const leaveIdx = leaveValues.findIndex(v => v.object.uuid === intersection.object.uuid);
+
+            if (leaveIdx !== -1) {
+              leaveValues.splice(leaveIdx, 1);
+            }
+          });
+          const leaving = leaveValues.map(intersection => {
+            return {
+              element: interactables?.value.find(interactable => interactable.instance?.uuid === intersection.object.uuid),
+              intersection
+            };
+          }); // new interactions
+
+          entering.forEach(({
+            element,
+            intersection
+          }) => {
+            fireEventsFromIntersections({
+              element,
+              eventKeys: ['onPointerEnter'],
+              intersection
+            });
+          }); // unchanged interactions
+
+          staying.forEach(({
+            element,
+            intersection
+          }) => {
+            const eventKeys = ['onPointerOver', 'onPointerMove'];
+            fireEventsFromIntersections({
+              element,
+              eventKeys,
+              intersection
+            });
+          }); // exited interactions
+
+          leaving.forEach(({
+            element,
+            intersection
+          }) => {
+            const eventKeys = ['onPointerLeave', 'onPointerOut'];
+            fireEventsFromIntersections({
+              element,
+              eventKeys,
+              intersection
+            });
+          });
+          currentIntersections = [].concat(entering, staying);
+        }; // update function
+
+
+        onBeforeRender(update);
+
+        const teardown = () => offBeforeRender(update);
+
+        vue.onBeforeUnmount(teardown);
+        const clickEventKeys = ['onClick', 'onPointerDown', 'onPointerUp'];
+        vue.watch(inputActive, isDown => {
+          // meshes with multiple intersections receive multiple callbacks by default -
+          // let's make it so they only receive one callback of each type per frame.
+          // (ie usually when you click on a mesh, you expect only one click event to fire, even
+          // if there are technically multiple intersections with that mesh)
+          const uuidsInteractedWithThisFrame = [];
+          currentIntersections.forEach(v => {
+            clickEventKeys.forEach(key => {
+              const id = v.element.uuid + key;
+
+              if (isDown && (key === 'onClick' || key === 'onPointerDown')) {
+                if (!uuidsInteractedWithThisFrame.includes(id)) {
+                  v.element.eventListeners[key]?.forEach(cb => cb({
+                    intersection: v.intersection
+                  }));
+                  uuidsInteractedWithThisFrame.push(id);
+                }
+              } else if (!isDown && key === 'onPointerUp') {
+                if (!uuidsInteractedWithThisFrame.includes(id)) {
+                  v.element.eventListeners[key]?.forEach(cb => cb({
+                    intersection: v.intersection
+                  }));
+                  uuidsInteractedWithThisFrame.push(id);
+                }
+              }
+            });
+          });
+        }); // return arbitrary object to ensure instantiation
+        // TODO: why can't we return a <raycaster/> here?
+
+        return () => vue.createVNode(vue.resolveComponent("object3D"), null, null);
+      }
+
+    });
+
     /** fixed & fill styling for container */
 
     const fillStyle = position => {
@@ -551,9 +518,10 @@
 
         if (props.r3f && THREE__namespace?.ColorManagement) {
           THREE__namespace.ColorManagement.legacyMode = false;
-        } // MOUNT
-        // ====================
+        }
 
+        const interactables = useLunchboxInteractables(); // MOUNT
+        // ====================
 
         vue.onMounted(async () => {
           // canvas needs to exist (or user needs to handle it on their own)
@@ -589,23 +557,17 @@
           updateGlobals?.({
             dpr
           });
-          console.log(1);
 
           while (!renderer.value?.$el?.instance && // TODO: remove `as any`
           !renderer.value?.component?.ctx.$el?.instance) {
-            console.log(2);
             await new Promise(r => requestAnimationFrame(r));
           }
 
-          console.log(3);
-
           while (!scene.value?.$el?.instance && // TODO: remove `as any`
           !scene.value?.component?.ctx.$el?.instance) {
-            console.log(4);
             await new Promise(r => requestAnimationFrame(r));
           }
 
-          console.log(5);
           const normalizedRenderer = renderer.value?.$el?.instance ?? renderer.value?.component?.ctx.$el?.instance;
           normalizedRenderer.setPixelRatio(globals.dpr);
           const normalizedScene = scene.value?.$el?.instance ?? scene.value?.component?.ctx.$el?.instance;
@@ -711,7 +673,7 @@
         }, consolidatedCameraProperties), null) : vue.createVNode(vue.resolveComponent("perspectiveCamera"), vue.mergeProps({
           "ref": camera,
           "args": props.cameraArgs ?? [props.r3f ? 75 : 45, 0.5625, 1, 1000]
-        }, consolidatedCameraProperties), null)]);
+        }, consolidatedCameraProperties), null), interactables?.value.length && vue.createVNode(LunchboxEventHandlers, null, null)]);
       }
 
     });
@@ -726,7 +688,7 @@
     'light', 'spotLightShadow', 'spotLight', 'pointLight', 'rectAreaLight', 'hemisphereLight', 'directionalLightShadow', 'directionalLight', 'ambientLight', 'lightShadow', 'ambientLightProbe', 'hemisphereLightProbe', 'lightProbe', // textures
     'texture', 'videoTexture', 'dataTexture', 'dataTexture3D', 'compressedTexture', 'cubeTexture', 'canvasTexture', 'depthTexture', // Texture loaders
     'textureLoader', // misc
-    'group', 'catmullRomCurve3', 'points', // helpers
+    'group', 'catmullRomCurve3', 'points', 'raycaster', // helpers
     'cameraHelper', // cameras
     'camera', 'perspectiveCamera', 'orthographicCamera', 'cubeCamera', 'arrayCamera', // renderers
     'webGLRenderer'
@@ -761,7 +723,6 @@
     arrowHelper: ArrowHelperProps
     axesHelper: AxesHelperProps
       // misc
-    raycaster: RaycasterProps
     vector2: Vector2Props
     vector3: Vector3Props
     vector4: Vector4Props
@@ -778,7 +739,7 @@
     */
     ];
 
-    const catalogue = {};
+    const catalogue = {}; // component creation utility
 
     const createComponent$1 = tag => vue.defineComponent({
       inheritAttrs: false,
@@ -1174,10 +1135,6 @@
       return item?.minidomType === 'RendererNode';
     }
 
-    // let watchStopHandle: WatchStopHandle
-    // export const beforeRender = [] as Lunch.UpdateCallback[]
-    // export const afterRender = [] as Lunch.UpdateCallback[]
-
     const requestUpdate = opts => {
       if (typeof opts.app.config.globalProperties.lunchbox.frameId === 'number') {
         cancelAnimationFrame(opts.app.config.globalProperties.lunchbox.frameId);
@@ -1266,22 +1223,7 @@
 
     const offAfterRender = cb => {
       useBeforeRender().offBeforeRender?.(cb);
-    }; // export const onAfterRender = (cb: Lunch.UpdateCallback, index = Infinity) => {
-    //     if (index === Infinity) {
-    //         afterRender.push(cb)
-    //     } else {
-    //         afterRender.splice(index, 0, cb)
-    //     }
-    // }
-    // export const offAfterRender = (cb: Lunch.UpdateCallback | number) => {
-    //     if (isFinite(cb as number)) {
-    //         afterRender.splice(cb as number, 1)
-    //     } else {
-    //         const idx = afterRender.findIndex((v) => v == cb)
-    //         afterRender.splice(idx, 1)
-    //     }
-    // }
-    // TODO: document
+    }; // TODO: document
 
     const useCancelUpdate = () => {
       const frameId = vue.inject(frameIdKey);
@@ -1303,28 +1245,12 @@
       useCancelUpdateSource()?.();
     };
 
-    /** Update the given node so all of its props are current. */
-
-    function updateAllObjectProps({
-      node
-    }) {
-      // set props
-      const props = node.props || {};
-      let output = node;
-      Object.keys(props).forEach(key => {
-        output = updateObjectProp({
-          node,
-          key,
-          value: props[key]
-        });
-      });
-      return output;
-    }
     /** Update a single prop on a given node. */
 
     function updateObjectProp({
       node,
       key,
+      interactables,
       value
     }) {
       // handle and return early if prop is an event
@@ -1333,6 +1259,7 @@
         return addEventListener({
           node,
           key,
+          interactables,
           value
         });
       } // update THREE property
@@ -1588,72 +1515,86 @@
         Elements are `create`d from the outside in, then `insert`ed from the inside out.
     */
 
-    const nodeOps = {
-      createElement,
-
-      createText(text) {
-        return createTextNode({
-          text
-        });
-      },
-
-      createComment(text) {
-        return createCommentNode({
-          text
-        });
-      },
-
-      insert,
-
-      nextSibling(node) {
-        const result = node.nextSibling; // console.log('found', result)
+    const createNodeOps = () => {
+      // APP-LEVEL GLOBALS
+      // ====================
+      // These need to exist at the app level in a place where the node ops can access them.
+      // It'd be better to set these via `app.provide` at app creation, but the node ops need access
+      // to these values before the app is instantiated, so this is the next-best place for them to exist.
+      const interactables = vue.ref([]); // NODE OPS
+      // ====================
 
-        if (!result) return null;
-        return result;
-      },
+      const nodeOps = {
+        createElement,
 
-      parentNode(node) {
-        const result = node.parentNode;
-        if (!result) return null;
-        return result;
-      },
+        createText(text) {
+          return createTextNode({
+            text
+          });
+        },
 
-      patchProp(node, key, prevValue, nextValue) {
-        if (isLunchboxDomComponent(node)) {
-          // handle DOM node
-          if (key === 'style') {
-            // special handling for style
-            Object.keys(nextValue).forEach(k => {
-              node.domElement.style[k] = nextValue[k];
-            });
-          } else {
-            node.domElement.setAttribute(key, nextValue);
-          }
+        createComment(text) {
+          return createCommentNode({
+            text
+          });
+        },
+
+        insert,
+
+        nextSibling(node) {
+          const result = node.nextSibling;
+          if (!result) return null;
+          return result;
+        },
+
+        parentNode(node) {
+          const result = node.parentNode;
+          if (!result) return null;
+          return result;
+        },
+
+        patchProp(node, key, prevValue, nextValue) {
+          if (isLunchboxDomComponent(node)) {
+            // handle DOM node
+            if (key === 'style') {
+              // special handling for style
+              Object.keys(nextValue).forEach(k => {
+                node.domElement.style[k] = nextValue[k];
+              });
+            } else {
+              node.domElement.setAttribute(key, nextValue);
+            }
 
-          return;
-        } // ignore if root node, or Lunchbox internal prop
+            return;
+          } // ignore if root node, or Lunchbox internal prop
 
 
-        if (isLunchboxRootNode(node) || key.startsWith('$')) {
-          return;
-        } // otherwise, update prop
+          if (isLunchboxRootNode(node) || key.startsWith('$')) {
+            return;
+          } // otherwise, update prop
 
 
-        updateObjectProp({
-          node: node,
-          key,
-          value: nextValue
-        });
-      },
+          updateObjectProp({
+            node: node,
+            key,
+            interactables,
+            value: nextValue
+          });
+        },
 
-      remove,
+        remove,
 
-      setElementText() {// noop
-      },
+        setElementText() {// noop
+        },
 
-      setText() {// noop
-      }
+        setText() {// noop
+        }
 
+      };
+      return {
+        nodeOps,
+        interactables
+      };
     };
 
     /** The current camera. Often easier to use `useCamera` instead of this. */
@@ -1756,11 +1697,20 @@
       } else {
         callbacks?.splice(index, 0, cb);
       }
-    }; // CREATE APP
+    }; // TODO: document
+
+    const useLunchboxInteractables = () => vue.inject(lunchboxInteractables); // CREATE APP
     // ====================
 
     const createApp = root => {
-      const app = vue.createRenderer(nodeOps).createApp(root); // register all components
+      const {
+        nodeOps,
+        interactables
+      } = createNodeOps();
+      const app = vue.createRenderer(nodeOps).createApp(root); // provide Lunchbox interaction handlers flag (modified when user references events via
+      // @click, etc)
+
+      app.provide(lunchboxInteractables, interactables); // register all components
       // ====================
 
       Object.keys(components).forEach(key => {
@@ -1911,7 +1861,6 @@
     };
 
     exports.addEventListener = addEventListener;
-    exports.addInteractable = addInteractable;
     exports.afterRenderKey = afterRenderKey;
     exports.appCameraKey = appCameraKey;
     exports.appKey = appKey;
@@ -1929,7 +1878,6 @@
     exports.createDomNode = createDomNode;
     exports.createNode = createNode;
     exports.createTextNode = createTextNode;
-    exports.currentIntersections = currentIntersections;
     exports.ensureRenderer = ensureRenderer;
     exports.ensuredCamera = ensuredCamera;
     exports.ensuredScene = ensuredScene;
@@ -1937,11 +1885,9 @@
     exports.find = find;
     exports.frameIdKey = frameIdKey;
     exports.globalsInjectionKey = globalsInjectionKey;
-    exports.inputActive = inputActive;
     exports.instantiateThreeObject = instantiateThreeObject;
-    exports.interactables = interactables;
     exports.isMinidomNode = isMinidomNode;
-    exports.mousePos = mousePos;
+    exports.lunchboxInteractables = lunchboxInteractables;
     exports.nestedPropertiesToCheck = nestedPropertiesToCheck;
     exports.offAfterRender = offAfterRender;
     exports.offAfterRenderKey = offAfterRenderKey;
@@ -1952,14 +1898,12 @@
     exports.onBeforeRender = onBeforeRender;
     exports.onBeforeRenderKey = onBeforeRenderKey;
     exports.onStart = onStart;
-    exports.removeInteractable = removeInteractable;
     exports.renderer = renderer;
     exports.scene = scene;
     exports.setCustomRender = setCustomRender;
     exports.setCustomRenderKey = setCustomRenderKey;
     exports.startCallbackKey = startCallbackKey;
     exports.update = update;
-    exports.updateAllObjectProps = updateAllObjectProps;
     exports.updateGlobals = updateGlobals;
     exports.updateGlobalsInjectionKey = updateGlobalsInjectionKey;
     exports.updateObjectProp = updateObjectProp;
@@ -1971,6 +1915,7 @@
     exports.useCancelUpdateSource = useCancelUpdateSource;
     exports.useCustomRender = useCustomRender;
     exports.useGlobals = useGlobals;
+    exports.useLunchboxInteractables = useLunchboxInteractables;
     exports.useRenderer = useRenderer;
     exports.useRootNode = useRootNode;
     exports.useScene = useScene;