@cavegiant/cave-world-r3f 1.0.0

package/dist/space/utils/touch-primary-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-primary-device.js","sources":["../../../space/utils/touch-primary-device.ts"],"sourcesContent":["import { useEffect, useSyncExternalStore } from 'react'\n\n/** Same media query as `@react-three/viverse` `useIsMobile`. */\nexport const VIVERSE_MOBILE_MEDIA_QUERY = '(hover: none) and (pointer: coarse)'\n\nconst TOUCH_PRIMARY_WATCH_QUERIES = [\n  VIVERSE_MOBILE_MEDIA_QUERY,\n  '(hover: none)',\n  '(hover: hover)',\n  '(pointer: fine)',\n  '(any-pointer: coarse)',\n  '(max-width: 1024px)'\n] as const\n\nconst TOUCH_CONTROLS_STYLE_ID = 'cave-world-touch-controls-style'\n\n/**\n * Whether the device should use on-screen joystick + touch look controls.\n *\n * viverse's `useIsMobile()` only matches `(hover: none) and (pointer: coarse)`.\n * Some phone browsers / in-app WebViews (WeChat, etc.) report `pointer: fine`, so\n * they get desktop pointer-lock bindings and `.mobile-only` UI stays hidden.\n */\nexport function isTouchPrimaryDevice(): boolean {\n  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {\n    return false\n  }\n\n  if (window.matchMedia(VIVERSE_MOBILE_MEDIA_QUERY).matches) {\n    return true\n  }\n\n  const hasTouch = (navigator.maxTouchPoints ?? 0) > 0 || 'ontouchstart' in window\n\n  if (!hasTouch) {\n    return false\n  }\n\n  // Touchscreen laptop with mouse — keep desktop keyboard + pointer-lock UX.\n  if (window.matchMedia('(pointer: fine)').matches && window.matchMedia('(hover: hover)').matches) {\n    return false\n  }\n\n  // Typical phones / tablets, including WebViews that misreport pointer type.\n  if (window.matchMedia('(max-width: 1024px)').matches) {\n    return true\n  }\n\n  if (window.matchMedia('(hover: none)').matches) {\n    return true\n  }\n\n  if (window.matchMedia('(any-pointer: coarse)').matches) {\n    return true\n  }\n\n  return false\n}\n\nfunction subscribeTouchPrimary(onStoreChange: () => void): () => void {\n  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {\n    return () => {}\n  }\n\n  const mediaQueries = TOUCH_PRIMARY_WATCH_QUERIES.map((query) => window.matchMedia(query))\n  const handler = () => onStoreChange()\n\n  for (const mediaQuery of mediaQueries) {\n    mediaQuery.addEventListener('change', handler)\n  }\n\n  return () => {\n    for (const mediaQuery of mediaQueries) {\n      mediaQuery.removeEventListener('change', handler)\n    }\n  }\n}\n\nfunction getTouchPrimarySnapshot(): boolean {\n  return isTouchPrimaryDevice()\n}\n\nfunction ensureTouchControlsStyles(): void {\n  if (typeof document === 'undefined' || document.getElementById(TOUCH_CONTROLS_STYLE_ID)) {\n    return\n  }\n\n  const style = document.createElement('style')\n  style.id = TOUCH_CONTROLS_STYLE_ID\n  // viverse injects `.mobile-only { display: none }` unless the coarse-pointer MQ\n  // matches — override when our broader touch detection says controls are needed.\n  style.textContent = 'html.cave-world-touch-controls .mobile-only{display:unset!important;}'\n  document.head.appendChild(style)\n}\n\nfunction syncTouchControlsDocumentClass(isTouchPrimary: boolean): void {\n  if (typeof document === 'undefined') return\n  ensureTouchControlsStyles()\n  document.documentElement.classList.toggle('cave-world-touch-controls', isTouchPrimary)\n}\n\n/**\n * Drop-in replacement for viverse `useIsMobile()` wherever touch locomotion UI\n * is chosen (joystick, jump button, pointer-capture look).\n */\nexport function useTouchPrimaryDevice(): boolean {\n  const isTouchPrimary = useSyncExternalStore(\n    subscribeTouchPrimary,\n    getTouchPrimarySnapshot,\n    () => false\n  )\n\n  useEffect(() => {\n    syncTouchControlsDocumentClass(isTouchPrimary)\n  }, [isTouchPrimary])\n\n  return isTouchPrimary\n}\n"],"names":["VIVERSE_MOBILE_MEDIA_QUERY","TOUCH_PRIMARY_WATCH_QUERIES","TOUCH_CONTROLS_STYLE_ID","isTouchPrimaryDevice","subscribeTouchPrimary","onStoreChange","mediaQueries","query","handler","mediaQuery","getTouchPrimarySnapshot","ensureTouchControlsStyles","style","syncTouchControlsDocumentClass","isTouchPrimary","useTouchPrimaryDevice","useSyncExternalStore","useEffect"],"mappings":";AAGO,MAAMA,IAA6B,uCAEpCC,IAA8B;AAAA,EAClCD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAEME,IAA0B;AASzB,SAASC,IAAgC;AAC9C,SAAI,OAAO,SAAW,OAAe,OAAO,OAAO,cAAe,aACzD,KAGL,OAAO,WAAWH,CAA0B,EAAE,UACzC,KAKL,GAFc,UAAU,kBAAkB,KAAK,KAAK,kBAAkB,WAOtE,OAAO,WAAW,iBAAiB,EAAE,WAAW,OAAO,WAAW,gBAAgB,EAAE,UAC/E,KAIL,UAAO,WAAW,qBAAqB,EAAE,WAIzC,OAAO,WAAW,eAAe,EAAE,WAInC,OAAO,WAAW,uBAAuB,EAAE;AAKjD;AAEA,SAASI,EAAsBC,GAAuC;AACpE,MAAI,OAAO,SAAW,OAAe,OAAO,OAAO,cAAe;AAChE,WAAO,MAAM;AAAA,IAAC;AAGhB,QAAMC,IAAeL,EAA4B,IAAI,CAACM,MAAU,OAAO,WAAWA,CAAK,CAAC,GAClFC,IAAU,MAAMH,EAAA;AAEtB,aAAWI,KAAcH;AACvB,IAAAG,EAAW,iBAAiB,UAAUD,CAAO;AAG/C,SAAO,MAAM;AACX,eAAWC,KAAcH;AACvB,MAAAG,EAAW,oBAAoB,UAAUD,CAAO;AAAA,EAEpD;AACF;AAEA,SAASE,IAAmC;AAC1C,SAAOP,EAAA;AACT;AAEA,SAASQ,IAAkC;AACzC,MAAI,OAAO,WAAa,OAAe,SAAS,eAAeT,CAAuB;AACpF;AAGF,QAAMU,IAAQ,SAAS,cAAc,OAAO;AAC5C,EAAAA,EAAM,KAAKV,GAGXU,EAAM,cAAc,yEACpB,SAAS,KAAK,YAAYA,CAAK;AACjC;AAEA,SAASC,EAA+BC,GAA+B;AACrE,EAAI,OAAO,WAAa,QACxBH,EAAA,GACA,SAAS,gBAAgB,UAAU,OAAO,6BAA6BG,CAAc;AACvF;AAMO,SAASC,IAAiC;AAC/C,QAAMD,IAAiBE;AAAA,IACrBZ;AAAA,IACAM;AAAA,IACA,MAAM;AAAA,EAAA;AAGR,SAAAO,EAAU,MAAM;AACd,IAAAJ,EAA+BC,CAAc;AAAA,EAC/C,GAAG,CAACA,CAAc,CAAC,GAEZA;AACT;"}

package/dist/space/utils/use-visibility-frameloop.d.ts

@@ -0,0 +1,20 @@
+/**
+ * R3F `frameloop` value driven by Page Visibility.
+ *
+ * When the page is hidden (tab switch, app backgrounded, screen lock) the
+ * render loop is stopped (`'never'`) so the GPU does zero work — splat scenes
+ * are extremely expensive to keep rendering at full frame rate and are the main
+ * driver of device heat. When the page is visible the loop runs normally
+ * (`'always'`), so behaviour is identical to the default when in foreground.
+ *
+ * Browsers throttle background `requestAnimationFrame` on their own, but the
+ * behaviour is inconsistent across mobile in-app WebViews (WeChat, etc.) and
+ * lock-screen states; setting `'never'` explicitly guarantees the loop halts.
+ */
+export type VisibilityFrameloop = 'always' | 'never';
+/**
+ * Returns the R3F `frameloop` mode that should be passed to a splat `<Canvas>`:
+ * `'never'` while the page is hidden, `'always'` while visible.
+ */
+export declare function useVisibilityFrameloop(): VisibilityFrameloop;
+//# sourceMappingURL=use-visibility-frameloop.d.ts.map

package/dist/space/utils/use-visibility-frameloop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visibility-frameloop.d.ts","sourceRoot":"","sources":["../../../space/utils/use-visibility-frameloop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAiBpD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D"}

package/dist/space/utils/use-visibility-frameloop.js

@@ -0,0 +1,18 @@
+import { useSyncExternalStore as i } from "react";
+function n(e) {
+  return typeof document > "u" ? () => {
+  } : (document.addEventListener("visibilitychange", e), () => document.removeEventListener("visibilitychange", e));
+}
+function t() {
+  return typeof document > "u" ? "always" : document.hidden ? "never" : "always";
+}
+function r() {
+  return "always";
+}
+function o() {
+  return i(n, t, r);
+}
+export {
+  o as useVisibilityFrameloop
+};
+//# sourceMappingURL=use-visibility-frameloop.js.map

package/dist/space/utils/use-visibility-frameloop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visibility-frameloop.js","sources":["../../../space/utils/use-visibility-frameloop.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react'\n\n/**\n * R3F `frameloop` value driven by Page Visibility.\n *\n * When the page is hidden (tab switch, app backgrounded, screen lock) the\n * render loop is stopped (`'never'`) so the GPU does zero work — splat scenes\n * are extremely expensive to keep rendering at full frame rate and are the main\n * driver of device heat. When the page is visible the loop runs normally\n * (`'always'`), so behaviour is identical to the default when in foreground.\n *\n * Browsers throttle background `requestAnimationFrame` on their own, but the\n * behaviour is inconsistent across mobile in-app WebViews (WeChat, etc.) and\n * lock-screen states; setting `'never'` explicitly guarantees the loop halts.\n */\nexport type VisibilityFrameloop = 'always' | 'never'\n\nfunction subscribeVisibility(onStoreChange: () => void): () => void {\n  if (typeof document === 'undefined') return () => {}\n  document.addEventListener('visibilitychange', onStoreChange)\n  return () => document.removeEventListener('visibilitychange', onStoreChange)\n}\n\nfunction getVisibilitySnapshot(): VisibilityFrameloop {\n  if (typeof document === 'undefined') return 'always'\n  return document.hidden ? 'never' : 'always'\n}\n\nfunction getServerSnapshot(): VisibilityFrameloop {\n  return 'always'\n}\n\n/**\n * Returns the R3F `frameloop` mode that should be passed to a splat `<Canvas>`:\n * `'never'` while the page is hidden, `'always'` while visible.\n */\nexport function useVisibilityFrameloop(): VisibilityFrameloop {\n  return useSyncExternalStore(subscribeVisibility, getVisibilitySnapshot, getServerSnapshot)\n}\n"],"names":["subscribeVisibility","onStoreChange","getVisibilitySnapshot","getServerSnapshot","useVisibilityFrameloop","useSyncExternalStore"],"mappings":";AAiBA,SAASA,EAAoBC,GAAuC;AAClE,SAAI,OAAO,WAAa,MAAoB,MAAM;AAAA,EAAC,KACnD,SAAS,iBAAiB,oBAAoBA,CAAa,GACpD,MAAM,SAAS,oBAAoB,oBAAoBA,CAAa;AAC7E;AAEA,SAASC,IAA6C;AACpD,SAAI,OAAO,WAAa,MAAoB,WACrC,SAAS,SAAS,UAAU;AACrC;AAEA,SAASC,IAAyC;AAChD,SAAO;AACT;AAMO,SAASC,IAA8C;AAC5D,SAAOC,EAAqBL,GAAqBE,GAAuBC,CAAiB;AAC3F;"}