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

package/dist/lunchboxjs.module.js

@@ -1,4 +1,4 @@
-import { isRef, isVNode, inject, ref, watch, toRaw, defineComponent, createVNode, resolveComponent, reactive, onMounted, onBeforeUnmount, Fragment, mergeProps, h, createRenderer, computed } from 'vue';
+import { isRef, isVNode, inject, toRaw, defineComponent, createVNode, resolveComponent, ref, watch, onBeforeUnmount, reactive, onMounted, Fragment, mergeProps, h, createRenderer, computed } from 'vue';
 import * as THREE from 'three';
 import { get, isNumber, set } from 'lodash';
 
@@ -119,6 +119,7 @@ const appKey = Symbol();
 const appRenderersKey = Symbol();
 const appSceneKey = Symbol();
 const appCameraKey = Symbol();
+const lunchboxInteractables = Symbol();
 const startCallbackKey = Symbol();
 
 const ensuredCamera = () => inject(appCameraKey); // ENSURE RENDERER
@@ -129,215 +130,11 @@ const ensureRenderer = () => inject(appRenderersKey); // ENSURE SCENE
 
 const ensuredScene = () => 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 = ref(false);
-
-// let mouseDownListener: (event: MouseEvent) => void
-// let mouseUpListener: (event: MouseEvent) => void
-
-const mousePos = 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
@@ -353,37 +150,18 @@ function addEventListener({
   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 = 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;
@@ -477,6 +255,195 @@ const LunchboxScene = defineComponent({
 
 });
 
+const LunchboxEventHandlers = defineComponent({
+  name: 'LunchboxEventHandlers',
+
+  setup() {
+    const interactables = useLunchboxInteractables();
+    const camera = useCamera();
+    const renderer = useRenderer();
+    const globals = useGlobals();
+    const mousePos = ref({
+      x: Infinity,
+      y: Infinity
+    });
+    const inputActive = ref(false);
+    let currentIntersections = [];
+    const raycaster = new THREE.Raycaster(new THREE.Vector3(), new THREE.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 = 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);
+
+    onBeforeUnmount(teardown);
+    const clickEventKeys = ['onClick', 'onPointerDown', 'onPointerUp'];
+    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 () => createVNode(resolveComponent("object3D"), null, null);
+  }
+
+});
+
 /** fixed & fill styling for container */
 
 const fillStyle = position => {
@@ -529,9 +496,10 @@ const LunchboxWrapper = defineComponent({
 
     if (props.r3f && THREE?.ColorManagement) {
       THREE.ColorManagement.legacyMode = false;
-    } // MOUNT
-    // ====================
+    }
 
+    const interactables = useLunchboxInteractables(); // MOUNT
+    // ====================
 
     onMounted(async () => {
       // canvas needs to exist (or user needs to handle it on their own)
@@ -567,23 +535,17 @@ const LunchboxWrapper = defineComponent({
       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;
@@ -689,7 +651,7 @@ const LunchboxWrapper = defineComponent({
     }, consolidatedCameraProperties), null) : createVNode(resolveComponent("perspectiveCamera"), mergeProps({
       "ref": camera,
       "args": props.cameraArgs ?? [props.r3f ? 75 : 45, 0.5625, 1, 1000]
-    }, consolidatedCameraProperties), null)]);
+    }, consolidatedCameraProperties), null), interactables?.value.length && createVNode(LunchboxEventHandlers, null, null)]);
   }
 
 });
@@ -704,7 +666,7 @@ const autoGeneratedComponents = [// ThreeJS basics
 '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'
@@ -739,7 +701,6 @@ planeHelper: PlaneHelperProps
 arrowHelper: ArrowHelperProps
 axesHelper: AxesHelperProps
   // misc
-raycaster: RaycasterProps
 vector2: Vector2Props
 vector3: Vector3Props
 vector4: Vector4Props
@@ -756,7 +717,7 @@ shape: ShapeProps
 */
 ];
 
-const catalogue = {};
+const catalogue = {}; // component creation utility
 
 const createComponent$1 = tag => defineComponent({
   inheritAttrs: false,
@@ -1152,10 +1113,6 @@ function isMinidomNode(item) {
   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);
@@ -1244,22 +1201,7 @@ const onAfterRender = (cb, index = Infinity) => {
 
 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 = inject(frameIdKey);
@@ -1281,28 +1223,12 @@ const cancelUpdateSource = () => {
   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
@@ -1311,6 +1237,7 @@ function updateObjectProp({
     return addEventListener({
       node,
       key,
+      interactables,
       value
     });
   } // update THREE property
@@ -1566,72 +1493,86 @@ const remove = node => {
     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 = 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. */
@@ -1734,11 +1675,20 @@ const onStart = (cb, index = Infinity) => {
   } else {
     callbacks?.splice(index, 0, cb);
   }
-}; // CREATE APP
+}; // TODO: document
+
+const useLunchboxInteractables = () => inject(lunchboxInteractables); // CREATE APP
 // ====================
 
 const createApp = root => {
-  const app = createRenderer(nodeOps).createApp(root); // register all components
+  const {
+    nodeOps,
+    interactables
+  } = createNodeOps();
+  const app = 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 => {
@@ -1888,4 +1838,4 @@ const createApp = root => {
   return app;
 };
 
-export { MiniDom, addEventListener, addInteractable, afterRenderKey, appCameraKey, appKey, appRenderersKey, appRootNodeKey, appSceneKey, beforeRenderKey, camera, cancelUpdate, cancelUpdateSource, clearCustomRender, clearCustomRenderKey, createApp, createCommentNode, createDomNode, createNode, createTextNode, currentIntersections, ensureRenderer, ensuredCamera, ensuredScene, extend, find, frameIdKey, globalsInjectionKey, inputActive, instantiateThreeObject, interactables, isMinidomNode, mousePos, nestedPropertiesToCheck, offAfterRender, offAfterRenderKey, offBeforeRender, offBeforeRenderKey, onAfterRender, onAfterRenderKey, onBeforeRender, onBeforeRenderKey, onStart, removeInteractable, renderer, scene, setCustomRender, setCustomRenderKey, startCallbackKey, update, updateAllObjectProps, updateGlobals, updateGlobalsInjectionKey, updateObjectProp, useAfterRender, useApp, useBeforeRender, useCamera, useCancelUpdate, useCancelUpdateSource, useCustomRender, useGlobals, useRenderer, useRootNode, useScene, useStartCallbacks, useUpdateGlobals, watchStopHandleKey };
+export { MiniDom, addEventListener, afterRenderKey, appCameraKey, appKey, appRenderersKey, appRootNodeKey, appSceneKey, beforeRenderKey, camera, cancelUpdate, cancelUpdateSource, clearCustomRender, clearCustomRenderKey, createApp, createCommentNode, createDomNode, createNode, createTextNode, ensureRenderer, ensuredCamera, ensuredScene, extend, find, frameIdKey, globalsInjectionKey, instantiateThreeObject, isMinidomNode, lunchboxInteractables, nestedPropertiesToCheck, offAfterRender, offAfterRenderKey, offBeforeRender, offBeforeRenderKey, onAfterRender, onAfterRenderKey, onBeforeRender, onBeforeRenderKey, onStart, renderer, scene, setCustomRender, setCustomRenderKey, startCallbackKey, update, updateGlobals, updateGlobalsInjectionKey, updateObjectProp, useAfterRender, useApp, useBeforeRender, useCamera, useCancelUpdate, useCancelUpdateSource, useCustomRender, useGlobals, useLunchboxInteractables, useRenderer, useRootNode, useScene, useStartCallbacks, useUpdateGlobals, watchStopHandleKey };