@ifiwas/standard-view 2.0.0

package/lib/utils/constants.js

@@ -0,0 +1,181 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Z_AXIS = exports.Y_AXIS = exports.X_AXIS = exports.SYNONYMOUS_CONTROLS_PROPS = exports.SYNONYMOUS_CAMERA_PROPS = exports.SIDE_TYPES = exports.MATERIAL_TYPES = exports.EULER_ORDERS = exports.DEFAULT_UP_VEC3 = exports.DEFAULT_UP = exports.DEFAULT_RIGHT_VEC3 = exports.DEFAULT_RIGHT = exports.DEFAULT_NORMAL_VEC3 = exports.DEFAULT_NORMAL = exports.CONTROLS_TYPES = exports.COLORS = exports.CAMERA_TYPES = exports.ANTONYMOUS_CONTROLS_PROPS = exports.ANCHOR_SYNONYMS = exports.ANCHORS = void 0;
+var THREE = _interopRequireWildcard(require("three"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+// constants.js
+
+var Z_AXIS = exports.Z_AXIS = new THREE.Vector3(0, 0, 1);
+var Y_AXIS = exports.Y_AXIS = new THREE.Vector3(0, 1, 0);
+var X_AXIS = exports.X_AXIS = new THREE.Vector3(1, 0, 0);
+var DEFAULT_UP_VEC3 = exports.DEFAULT_UP_VEC3 = Y_AXIS.clone();
+var DEFAULT_NORMAL_VEC3 = exports.DEFAULT_NORMAL_VEC3 = Z_AXIS.clone();
+var DEFAULT_RIGHT_VEC3 = exports.DEFAULT_RIGHT_VEC3 = X_AXIS.clone();
+var DEFAULT_NORMAL = exports.DEFAULT_NORMAL = [0, 0, 1];
+var DEFAULT_UP = exports.DEFAULT_UP = [0, 1, 0];
+var DEFAULT_RIGHT = exports.DEFAULT_RIGHT = [1, 0, 0];
+
+// Side Types
+var SIDE_TYPES = exports.SIDE_TYPES = {
+  front: THREE.FrontSide,
+  back: THREE.BackSide,
+  "double": THREE.DoubleSide
+};
+
+// Euler Orders
+var EULER_ORDERS = exports.EULER_ORDERS = {
+  XYZ: "XYZ",
+  XZY: "XZY",
+  YXZ: "YXZ",
+  YZX: "YZX",
+  ZXY: "ZXY",
+  ZYX: "ZYX"
+};
+
+// Control Types
+var CONTROLS_TYPES = exports.CONTROLS_TYPES = {
+  ORBIT_CONTROLS: "orbitControls",
+  TRACKBALL_CONTROLS: "trackballControls",
+  MAP_CONTROLS: "mapControls"
+};
+var CAMERA_TYPES = exports.CAMERA_TYPES = {
+  ORTHOGRAPHIC: "orthographic",
+  PERSPECTIVE: "perspective"
+};
+var SYNONYMOUS_CONTROLS_PROPS = exports.SYNONYMOUS_CONTROLS_PROPS = [{
+  orbitControls: "dampingFactor",
+  mapControls: "dampingFactor",
+  trackballControls: "dynamicDampingFactor"
+}];
+var ANTONYMOUS_CONTROLS_PROPS = exports.ANTONYMOUS_CONTROLS_PROPS = [{
+  orbitControls: "enableZoom",
+  mapControls: "enableZoom",
+  trackballControls: "noZoom"
+}, {
+  orbitControls: "enableRotate",
+  mapControls: "enableRotate",
+  trackballControls: "noRotate"
+}, {
+  orbitControls: "enablePan",
+  mapControls: "enablePan",
+  trackballControls: "noPan"
+}, {
+  orbitControls: "enableDamping",
+  mapControls: "enableDamping",
+  trackballControls: "staticMoving"
+}];
+var SYNONYMOUS_CAMERA_PROPS = exports.SYNONYMOUS_CAMERA_PROPS = [{
+  perspective: "minDistance",
+  orthographic: "minZoom"
+}, {
+  perspective: "maxDistance",
+  orthographic: "maxZoom"
+}];
+
+// Material Types
+var MATERIAL_TYPES = exports.MATERIAL_TYPES = {
+  material: "material",
+  basic: "meshBasicMaterial",
+  linebasic: "lineBasicMaterial",
+  linedashed: "lineDashedMaterial",
+  depth: "meshDepthMaterial",
+  distance: "meshDistanceMaterial",
+  lambert: "meshLambertMaterial",
+  matcap: "meshMatcapMaterial",
+  normal: "meshNormalMaterial",
+  phong: "meshPhongMaterial",
+  physical: "meshPhysicalMaterial",
+  standard: "meshStandardMaterial",
+  toon: "meshToonMaterial",
+  points: "pointsMaterial",
+  rawshader: "rawShaderMaterial",
+  shader: "shaderMaterial",
+  shadow: "shadowMaterial",
+  sprite: "spriteMaterial"
+};
+
+// Simple, Distinct Colors
+var COLORS = exports.COLORS = ["#e6194b", "#3cb44b", "#ffe119", "#4363d8", "#f58231", "#911eb4", "#46f0f0", "#f032e6", "#bcf60c", "#fabebe", "#008080", "#e6beff", "#9a6324", "#fffac8", "#800000", "#aaffc3", "#808000", "#ffd8b1", "#000075", "#808080", "#ffffff", "#000000"];
+
+/**
+ * BASE_ANCHORS
+ *
+ * The ◼'s represent the anchor points.
+ *
+ *    ◼----◼----◼
+ *    |         |
+ *    ◼    ◼    ◼
+ *    |         |
+ *    ◼----◼----◼
+ */
+var ANCHORS = exports.ANCHORS = {
+  "top-left": new THREE.Vector3(-0.5, 0.5, 0),
+  top: new THREE.Vector3(0, 0.5, 0),
+  "top-right": new THREE.Vector3(0.5, 0.5, 0),
+  left: new THREE.Vector3(-0.5, 0, 0),
+  center: new THREE.Vector3(0, 0, 0),
+  right: new THREE.Vector3(0.5, 0, 0),
+  "bottom-left": new THREE.Vector3(-0.5, -0.5, 0),
+  bottom: new THREE.Vector3(0, -0.5, 0),
+  "bottom-right": new THREE.Vector3(0.5, -0.5, 0)
+};
+
+/**
+ * ANCHOR_SYNONYMS
+ *
+ * Synonym map of anchor locations for aligmment positions.
+ */
+var ANCHOR_SYNONYMS = exports.ANCHOR_SYNONYMS = {
+  "top-left": "top-left",
+  "up-left": "top-left",
+  "left-top": "top-left",
+  "left-up": "top-left",
+  top: "top",
+  up: "top",
+  "top-center": "top",
+  "top-middle": "top",
+  "up-center": "top",
+  "up-middle": "top",
+  "center-top": "top",
+  "center-up": "top",
+  "middle-top": "top",
+  "middle-up": "top",
+  "top-right": "top-right",
+  "up-right": "top-right",
+  "right-top": "top-right",
+  "right-up": "top-right",
+  left: "left",
+  "center-left": "left",
+  "middle-left": "left",
+  "left-center": "left",
+  "left-middle": "left",
+  center: "center",
+  middle: "center",
+  right: "right",
+  "center-right": "right",
+  "middle-right": "right",
+  "right-center": "right",
+  "right-middle": "right",
+  "bottom-left": "bottom-left",
+  "down-left": "bottom-left",
+  "left-bottom": "bottom-left",
+  "left-down": "bottom-left",
+  bottom: "bottom",
+  down: "bottom",
+  "bottom-center": "bottom",
+  "bottom-middle": "bottom",
+  "down-center": "bottom",
+  "down-middle": "bottom",
+  "center-bottom": "bottom",
+  "center-down": "bottom",
+  "middle-bottom": "bottom",
+  "middle-down": "bottom",
+  "bottom-right": "bottom-right",
+  "down-right": "bottom-right",
+  "right-bottom": "bottom-right",
+  "right-down": "bottom-right"
+};

package/lib/utils/events.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import { RenderCallback } from "@react-three/fiber";
+export declare function checkPropagation(e: any, mousePropagation: boolean): void;
+interface HandleClickProps {
+    mousePropagation: boolean;
+    clickSensitivity: number;
+    eventProps: any;
+    onClick?: Function;
+    onDoubleClick?: Function;
+}
+export declare function handleClick({ mousePropagation, clickSensitivity, eventProps, onClick, onDoubleClick }: HandleClickProps): React.MouseEventHandler;
+interface AnimationComponentProps {
+    animation: RenderCallback;
+}
+/**
+ * AnimationComponent
+ *
+ * Isolate @react-three/fiber's useFrame hook to add animation
+ * function to three's render loop.
+ */
+export declare const AnimationComponent: React.NamedExoticComponent<AnimationComponentProps>;
+export {};

package/lib/utils/events.js

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AnimationComponent = void 0;
+exports.checkPropagation = checkPropagation;
+exports.handleClick = handleClick;
+var React = _interopRequireWildcard(require("react"));
+var _hooks = require("./hooks");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } // events.tsx
+var memo = React.memo;
+
+// -----   Event Function Helpers   ----- //
+// Check Mouse Propagation
+function checkPropagation(e, mousePropagation) {
+  if (!mousePropagation) {
+    e.stopPropagation();
+  }
+}
+
+// Handle Click and Double Click
+
+function handleClick(_ref) {
+  var mousePropagation = _ref.mousePropagation,
+    clickSensitivity = _ref.clickSensitivity,
+    eventProps = _ref.eventProps,
+    onClick = _ref.onClick,
+    onDoubleClick = _ref.onDoubleClick;
+  return function (e) {
+    // Mouse Propagation
+    checkPropagation(e, mousePropagation);
+
+    // No Click Functions
+    if (!onClick && !onDoubleClick) {
+      return null;
+    }
+    var state = eventProps.state;
+
+    // No onDoubleClick
+    if (onClick && !onDoubleClick) {
+      // @ts-ignore TS2722 // Cannot invoke an object which is possible undefined
+      onClick(_objectSpread(_objectSpread({}, e), eventProps));
+      return null;
+    }
+
+    // Click Time
+    var currentTime = Date.now();
+
+    // Double Click
+    if (onDoubleClick) {
+      if (currentTime - state.lastClickTime <= clickSensitivity) {
+        // Set Last Click
+        state.lastClickTime = currentTime;
+        // @ts-ignore TS2722 // Cannot invoke an object which is possible undefined
+        onDoubleClick(_objectSpread(_objectSpread({}, e), eventProps));
+        return null;
+      }
+    }
+
+    // Single Click
+    if (onClick) {
+      // Waits to check for Double Click before executing
+      setTimeout(function () {
+        var initialClickTime = currentTime;
+        if (state.lastClickTime === initialClickTime) {
+          // @ts-ignore TS2722 // Cannot invoke an object which is possible undefined
+          onClick(_objectSpread(_objectSpread({}, e), eventProps));
+        }
+        return null;
+      }, clickSensitivity + 1);
+    }
+
+    // Set Last Click
+    state.lastClickTime = currentTime;
+    return null;
+  };
+}
+/**
+ * AnimationComponent
+ *
+ * Isolate @react-three/fiber's useFrame hook to add animation
+ * function to three's render loop.
+ */
+var AnimationComponent = exports.AnimationComponent = memo(/* eslint-disable react/prop-types */
+function AnimationComponent(_ref2) {
+  var animation = _ref2.animation;
+  (0, _hooks.useAnimationFrame)(animation, [animation]);
+  return null;
+}
+/* eslint-enable react/prop-types */);
+AnimationComponent.displayName = "AnimationComponent";

package/lib/utils/hooks.d.ts

@@ -0,0 +1,8 @@
+import { RenderCallback } from "@react-three/fiber";
+export declare function useToggle(initialValue: any, alternate?: any): [any, Function];
+export declare function useFrame(f: RenderCallback, priority?: number, override?: boolean): void;
+export declare function useViewContext(): any;
+/**
+ * useAnimationFrame
+ */
+export declare const useAnimationFrame: (callback: any, dependencies?: any[]) => void;

package/lib/utils/hooks.js

@@ -0,0 +1,96 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAnimationFrame = void 0;
+exports.useFrame = useFrame;
+exports.useToggle = useToggle;
+exports.useViewContext = useViewContext;
+var _react = require("react");
+var _fiber = require("@react-three/fiber");
+var _ViewContext = require("../views/ViewContext");
+var _excluded = ["setViewContextValue"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } // hooks.ts
+/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+function useToggle(initialValue, alternate) {
+  var _useState = (0, _react.useState)(initialValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    value = _useState2[0],
+    setValue = _useState2[1];
+  var alternateValue = (0, _react.useMemo)(function initAlternateValue() {
+    return alternate != null ? alternate : !initialValue;
+  }, [alternate, initialValue]);
+  function toggleValue() {
+    var newValue = value === initialValue ? alternateValue : initialValue;
+    setValue(newValue);
+  }
+  return [value, toggleValue];
+}
+function useFrame(f) {
+  var priority = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  var override = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+  var p = priority;
+  if (!override) {
+    p = p >= 2 ? p : 2;
+  }
+  (0, _fiber.useFrame)(f, p);
+}
+
+/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+function useViewContext() {
+  var _useContext = (0, _react.useContext)(_ViewContext.ViewContext),
+    setViewContextValue = _useContext.setViewContextValue,
+    canvasProps = _objectWithoutProperties(_useContext, _excluded);
+  var setViewContext = (0, _react.useCallback)(/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+  function updateSetViewContext(props) {
+    Object.entries(props).map(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        key = _ref2[0],
+        value = _ref2[1];
+      // Replace Existing Key-Value or Add New Key-Value
+      canvasProps[key] = value;
+      return null;
+    });
+    setViewContextValue(canvasProps);
+  }, [setViewContextValue, canvasProps]);
+  return _objectSpread({
+    setViewContext: setViewContext
+  }, canvasProps);
+}
+
+/**
+ * useAnimationFrame
+ */
+/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+var useAnimationFrame = exports.useAnimationFrame = function useAnimationFrame(callback, dependencies) {
+  // Use useRef for mutable variables that we want to persist
+  // without triggering a re-render on their change
+  var requestRef = (0, _react.useRef)(undefined);
+  function animate() {
+    callback();
+    requestRef.current = requestAnimationFrame(animate);
+  }
+  (0, _react.useEffect)(function () {
+    animate();
+    return function () {
+      if (requestRef.current != null) {
+        cancelAnimationFrame(requestRef.current);
+      }
+    };
+    /* eslint-disable-next-line react-hooks/exhaustive-deps */
+  }, dependencies); // Make sure the effect runs only once
+};

package/lib/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { Z_AXIS, Y_AXIS, X_AXIS, DEFAULT_UP_VEC3, DEFAULT_NORMAL_VEC3, DEFAULT_RIGHT_VEC3, DEFAULT_UP, DEFAULT_NORMAL, DEFAULT_RIGHT, SIDE_TYPES, CONTROLS_TYPES, CAMERA_TYPES } from "./constants";
+export { FPS, billboard } from "./util";
+export { useFrame, useViewContext, useAnimationFrame } from "./hooks";

package/lib/utils/index.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "CAMERA_TYPES", {
+  enumerable: true,
+  get: function get() {
+    return _constants.CAMERA_TYPES;
+  }
+});
+Object.defineProperty(exports, "CONTROLS_TYPES", {
+  enumerable: true,
+  get: function get() {
+    return _constants.CONTROLS_TYPES;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_NORMAL", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_NORMAL;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_NORMAL_VEC3", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_NORMAL_VEC3;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_RIGHT", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_RIGHT;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_RIGHT_VEC3", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_RIGHT_VEC3;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_UP", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_UP;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_UP_VEC3", {
+  enumerable: true,
+  get: function get() {
+    return _constants.DEFAULT_UP_VEC3;
+  }
+});
+Object.defineProperty(exports, "FPS", {
+  enumerable: true,
+  get: function get() {
+    return _util.FPS;
+  }
+});
+Object.defineProperty(exports, "SIDE_TYPES", {
+  enumerable: true,
+  get: function get() {
+    return _constants.SIDE_TYPES;
+  }
+});
+Object.defineProperty(exports, "X_AXIS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.X_AXIS;
+  }
+});
+Object.defineProperty(exports, "Y_AXIS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.Y_AXIS;
+  }
+});
+Object.defineProperty(exports, "Z_AXIS", {
+  enumerable: true,
+  get: function get() {
+    return _constants.Z_AXIS;
+  }
+});
+Object.defineProperty(exports, "billboard", {
+  enumerable: true,
+  get: function get() {
+    return _util.billboard;
+  }
+});
+Object.defineProperty(exports, "useAnimationFrame", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useAnimationFrame;
+  }
+});
+Object.defineProperty(exports, "useFrame", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useFrame;
+  }
+});
+Object.defineProperty(exports, "useViewContext", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useViewContext;
+  }
+});
+var _constants = require("./constants");
+var _util = require("./util");
+var _hooks = require("./hooks");

package/lib/utils/interfaces.d.ts

@@ -0,0 +1,9 @@
+import * as THREE from "three";
+export declare namespace StandardViewTypes {
+    type Geometries = THREE.BufferGeometry | THREE.BoxGeometry | THREE.CircleGeometry | THREE.CylinderGeometry | THREE.PlaneGeometry | THREE.SphereGeometry | THREE.EdgesGeometry;
+    type Point = Array<number> | {
+        x: number;
+        y: number;
+        z: number;
+    };
+}

package/lib/utils/interfaces.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/utils/math.d.ts

@@ -0,0 +1,12 @@
+export declare const EPS = 0.000001;
+export declare const EPS_NANO = 1e-9;
+export declare function nextPowerOfTwo(x: number): number;
+/**
+ * randomBetween lower and upper, including lower but not upper.
+ */
+export declare function randomBetween(lower: number, upper: number): number;
+/**
+ * minmax
+ * Given a number, it will be bounded by the given min and max.
+ */
+export declare function minmax(target: number, min: number, max: number): number;

package/lib/utils/math.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EPS_NANO = exports.EPS = void 0;
+exports.minmax = minmax;
+exports.nextPowerOfTwo = nextPowerOfTwo;
+exports.randomBetween = randomBetween;
+// math.ts
+
+var EPS = exports.EPS = 1e-6;
+var EPS_NANO = exports.EPS_NANO = 1e-9;
+function nextPowerOfTwo(x) {
+  return Math.pow(2, Math.ceil(Math.log2(x)));
+}
+
+/**
+ * randomBetween lower and upper, including lower but not upper.
+ */
+function randomBetween(lower, upper) {
+  return Math.random() * (upper - lower) + lower;
+}
+
+/**
+ * minmax
+ * Given a number, it will be bounded by the given min and max.
+ */
+function minmax(target, min, max) {
+  return Math.min(Math.max(target, min), max);
+}

package/lib/utils/performance.d.ts

@@ -0,0 +1,7 @@
+export declare function performanceStart(name?: string, stopwatchMode?: boolean): void;
+export declare function performanceEnd(name?: string): void;
+export declare function performanceLog(name?: string, print?: boolean): {
+    average: number;
+    total: number;
+    count: number;
+};