@ifiwas/standard-view 2.0.0

package/lib/primitives/Plane.js

@@ -0,0 +1,47 @@
+"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["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var THREE = _interopRequireWildcard(require("three"));
+var _Mesh = _interopRequireDefault(require("./Mesh"));
+var _util = require("../utils/util");
+var _excluded = ["side", "billboard", "children"]; // Plane.tsx
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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 _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+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; }
+var useMemo = React.useMemo,
+  memo = React.memo;
+/**
+ * Plane
+ *
+ * In Standard View, the Plane mesh is rotated to match the normal
+ * property if provided. This allows for easier create of Planes.
+ * All other properties are pass along to the Plane's Mesh.
+ *
+ * @param {PlaneProps} props
+ */
+var Plane = function Plane(_ref) {
+  var _ref$side = _ref.side,
+    side = _ref$side === void 0 ? "double" : _ref$side,
+    billboard = _ref.billboard,
+    children = _ref.children,
+    otherProps = _objectWithoutProperties(_ref, _excluded);
+  // Plane Buffer Geometry
+  var geometry = useMemo(function initGeometry() {
+    return new THREE.PlaneGeometry(1, 1, 1);
+  }, []);
+  return /*#__PURE__*/React.createElement(_Mesh["default"], _extends({
+    side: side,
+    geometry: geometry,
+    animation: billboard ? _util.billboard : undefined
+  }, otherProps), children);
+};
+var PlaneMemo = memo(Plane);
+PlaneMemo.displayName = "Plane";
+var _default = exports["default"] = PlaneMemo;

package/lib/primitives/Polygon.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+import { MeshProps } from "./Mesh";
+interface PolygonProps extends MeshProps {
+    points?: Array<Array<number>>;
+    depth?: number;
+}
+declare const PolygonMemo: React.NamedExoticComponent<PolygonProps>;
+export default PolygonMemo;

package/lib/primitives/Polygon.js

@@ -0,0 +1,75 @@
+"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["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var THREE = _interopRequireWildcard(require("three"));
+var _Mesh = _interopRequireDefault(require("./Mesh"));
+var _excluded = ["points", "depth", "children"]; // Polygon.tsx
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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 _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+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 _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; }
+var memo = React.memo;
+/**
+ * Polygon
+ *
+ * In Standard View, Polygon actually composes a THREE.ExtrudeBufferGeometry.
+ * The points need to be 2d and passed in drawing order.
+ * By providing depth, we can create the polygonal prism.
+ * Like most other 3D objects, this is also composed with Mesh and so all
+ * Mesh properties may be applied.
+ *
+ * @param {PolygonProps} props
+ */
+var Polygon = function Polygon(_ref) {
+  var _ref$points = _ref.points,
+    points = _ref$points === void 0 ? [[0, 0], [2, 0], [3, 1], [2, 2], [0, 2]] : _ref$points,
+    _ref$depth = _ref.depth,
+    depth = _ref$depth === void 0 ? 0 : _ref$depth,
+    children = _ref.children,
+    otherProps = _objectWithoutProperties(_ref, _excluded);
+  var shape = React.useMemo(function initShape() {
+    /* eslint-disable-next-line no-shadow */
+    var shape = new THREE.Shape();
+    if (points.length <= 2) return shape;
+
+    // Move to start point
+    // @ts-ignore:T2345
+    shape.moveTo.apply(shape, _toConsumableArray(points[0]));
+    // Connect points except for start point
+    // @ts-ignore:T2345
+    points.slice(1).forEach(function (point) {
+      return shape.lineTo.apply(shape, _toConsumableArray(point));
+    });
+    return shape;
+  }, [points]);
+  var options = React.useMemo(function initOptions() {
+    return {
+      steps: 1,
+      depth: depth,
+      bevelEnabled: false
+    };
+  }, [depth]);
+
+  // Extrude Buffer Geometry
+  var geometry = React.useMemo(function initGeometry() {
+    return new THREE.ExtrudeGeometry(shape, options);
+  }, [shape, options]);
+  return /*#__PURE__*/React.createElement(_Mesh["default"], _extends({
+    geometry: geometry
+  }, otherProps), children);
+};
+var PolygonMemo = memo(Polygon);
+PolygonMemo.displayName = "Polygon";
+var _default = exports["default"] = PolygonMemo;

package/lib/primitives/Quad.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import { MeshProps } from "./Mesh";
+interface QuadProps extends MeshProps {
+    points?: Array<Array<number>>;
+    indices?: Array<Array<number>>;
+    coplanarThreshold?: number;
+}
+declare const QuadMemo: React.NamedExoticComponent<QuadProps>;
+export default QuadMemo;

package/lib/primitives/Quad.js

@@ -0,0 +1,110 @@
+"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["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var THREE = _interopRequireWildcard(require("three"));
+var _Triangle = _interopRequireDefault(require("./Triangle"));
+var _math = require("../utils/math");
+var _excluded = ["points", "indices", "coplanarThreshold", "side", "children"]; // Quad.tsx
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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 _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _construct(t, e, r) { if (_isNativeReflectConstruct()) return Reflect.construct.apply(null, arguments); var o = [null]; o.push.apply(o, e); var p = new (t.bind.apply(t, o))(); return r && _setPrototypeOf(p, r.prototype), p; }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+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 _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; }
+var useEffect = React.useEffect,
+  useMemo = React.useMemo,
+  memo = React.memo;
+/**
+ * Quad
+ *
+ * In Standard View, Quad is actually composed with a Triangle,
+ * employing THREE.BufferGeometry underneath. Unlike Triangle,
+ * which can take an arbitrary number of vertices, Quad is
+ * limited to exactly 4.
+ *
+ * @param {QuadProps} props
+ */
+var Quad = function Quad(_ref) {
+  var _ref$points = _ref.points,
+    points = _ref$points === void 0 ? [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]] : _ref$points,
+    _ref$indices = _ref.indices,
+    indices = _ref$indices === void 0 ? [[0, 1, 2], [2, 3, 0]] : _ref$indices,
+    _ref$coplanarThreshol = _ref.coplanarThreshold,
+    coplanarThreshold = _ref$coplanarThreshol === void 0 ? _math.EPS_NANO : _ref$coplanarThreshol,
+    _ref$side = _ref.side,
+    side = _ref$side === void 0 ? "double" : _ref$side,
+    children = _ref.children,
+    otherProps = _objectWithoutProperties(_ref, _excluded);
+  // Points
+  var _points = useMemo(function updatePoints() {
+    // Default Points
+    var p = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]];
+
+    // Valid points
+    if (Array.isArray(points)) {
+      p = points;
+    }
+
+    // Exactly 4 Points
+    if (p.length > 4) {
+      // Too Many Points
+      p = p.slice(0, 4);
+    } else if (p.length < 4) {
+      // Too Few Points
+      while (p.length < 4) {
+        p.push([0, 0, 0]);
+      }
+    }
+    return p;
+  }, [points]);
+
+  // Indices
+  var _indices = useMemo(function updateIndices() {
+    // Default Indices
+    var ind = [[0, 1, 2], [2, 3, 0]];
+
+    // Valid indices
+    if (Array.isArray(indices) && indices.length === 2) {
+      ind = indices;
+    }
+    return ind;
+  }, [indices]);
+
+  // Planarity
+  useEffect(function checkPlanarity() {
+    var p0 = _construct(THREE.Vector3, _toConsumableArray(_points[0]));
+    var p1 = _construct(THREE.Vector3, _toConsumableArray(_points[1]));
+    var p2 = _construct(THREE.Vector3, _toConsumableArray(_points[2]));
+    var p3 = _construct(THREE.Vector3, _toConsumableArray(_points[3]));
+    var p01 = p1.clone().sub(p0);
+    var p02 = p2.clone().sub(p0);
+    var p03 = p3.clone().sub(p0);
+    var p01x02 = p01.clone().cross(p02).normalize();
+    var p01x03 = p01.clone().cross(p03).normalize();
+    if (Math.abs(p01x02.dot(p01x03)) < 1 - coplanarThreshold) {
+      /* eslint-disable-next-line no-console */
+      console.warn("[Quad] Points are not co-planar!");
+    }
+  }, [_points, coplanarThreshold]);
+  return /*#__PURE__*/React.createElement(_Triangle["default"], _extends({
+    points: _points,
+    indices: _indices,
+    side: side
+  }, otherProps), children);
+};
+var QuadMemo = memo(Quad);
+QuadMemo.displayName = "Quad";
+var _default = exports["default"] = QuadMemo;

package/lib/primitives/Sphere.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+import { MeshProps } from "./Mesh";
+interface SphereProps extends MeshProps {
+    radius?: number;
+    widthSegments?: number;
+    heightSegments?: number;
+    phiStart?: number;
+    phiLength?: number;
+    thetaStart?: number;
+    thetaLength?: number;
+    scale?: Array<number>;
+}
+declare const SphereMemo: React.NamedExoticComponent<SphereProps>;
+export default SphereMemo;

package/lib/primitives/Sphere.js

@@ -0,0 +1,92 @@
+"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["default"] = void 0;
+var React = _interopRequireWildcard(require("react"));
+var THREE = _interopRequireWildcard(require("three"));
+var _Mesh = _interopRequireDefault(require("./Mesh"));
+var _math = require("../utils/math");
+var _performance = require("../utils/performance");
+var _excluded = ["radius", "widthSegments", "heightSegments", "phiStart", "phiLength", "thetaStart", "thetaLength", "scale", "children"]; // Sphere.tsx
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+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 _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _construct(t, e, r) { if (_isNativeReflectConstruct()) return Reflect.construct.apply(null, arguments); var o = [null]; o.push.apply(o, e); var p = new (t.bind.apply(t, o))(); return r && _setPrototypeOf(p, r.prototype), p; }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+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 _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; }
+var useMemo = React.useMemo,
+  memo = React.memo,
+  forwardRef = React.forwardRef;
+/**
+ * Sphere
+ *
+ * In Standard View, the radius property of Sphere is used to scale the
+ * Mesh appropriately. The actual geometry is constructed with unit radius.
+ * The number of widthSegments and heightSegments, however may be specified
+ * to determine how smooth the sphere looks. More segments will incur
+ * renderring more triangles.
+ *
+ * @param {SphereProps} props
+ */
+var Sphere = forwardRef(function Sphere(_ref, ref) {
+  var _ref$radius = _ref.radius,
+    radius = _ref$radius === void 0 ? 1 : _ref$radius,
+    _ref$widthSegments = _ref.widthSegments,
+    widthSegments = _ref$widthSegments === void 0 ? 32 : _ref$widthSegments,
+    _ref$heightSegments = _ref.heightSegments,
+    heightSegments = _ref$heightSegments === void 0 ? 32 : _ref$heightSegments,
+    _ref$phiStart = _ref.phiStart,
+    phiStart = _ref$phiStart === void 0 ? 0 : _ref$phiStart,
+    _ref$phiLength = _ref.phiLength,
+    phiLength = _ref$phiLength === void 0 ? Math.PI * 2 : _ref$phiLength,
+    _ref$thetaStart = _ref.thetaStart,
+    thetaStart = _ref$thetaStart === void 0 ? 0 : _ref$thetaStart,
+    _ref$thetaLength = _ref.thetaLength,
+    thetaLength = _ref$thetaLength === void 0 ? Math.PI : _ref$thetaLength,
+    scale = _ref.scale,
+    children = _ref.children,
+    otherProps = _objectWithoutProperties(_ref, _excluded);
+  (0, _performance.performanceStart)("Sphere");
+
+  // Radius
+  var _scale = useMemo(function updateScale() {
+    var r = Math.max(radius, _math.EPS);
+
+    // Zero Radius Warning
+    if (r === _math.EPS) {
+      /* eslint-disable-next-line no-console */
+      console.warn("[Sphere] Zero radius!");
+    }
+    return scale || [r, r, r];
+  }, [scale, radius]);
+
+  // Sphere Arguments
+  var sphereArgs = useMemo(function updateSphereArgs() {
+    return [1, widthSegments, heightSegments, phiStart, phiLength, thetaStart, thetaLength];
+  }, [widthSegments, heightSegments, phiStart, phiLength, thetaStart, thetaLength]);
+
+  // Sphere Buffer Geometry
+  var geometry = useMemo(function initGeometry() {
+    return _construct(THREE.SphereGeometry, _toConsumableArray(sphereArgs));
+  }, [sphereArgs]);
+  (0, _performance.performanceEnd)("Sphere");
+  return /*#__PURE__*/React.createElement(React.Fragment, null, (0, _performance.performanceStart)("Around Mesh"), /*#__PURE__*/React.createElement(_Mesh["default"], _extends({
+    ref: ref,
+    scale: _scale,
+    geometry: geometry
+  }, otherProps), children), (0, _performance.performanceEnd)("Around Mesh"));
+});
+var SphereMemo = memo(Sphere);
+SphereMemo.displayName = "Sphere";
+var _default = exports["default"] = SphereMemo;

package/lib/primitives/Text.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import { MeshProps } from './Mesh';
+interface TextProps extends MeshProps {
+    text?: string;
+    fontName?: string;
+    fontFile?: string;
+    size?: number;
+    height?: number;
+    depth?: number;
+    align?: string;
+    curveSegments?: number;
+    bevelEnabled?: boolean;
+    bevelThickness?: number;
+    bevelSize?: number;
+    bevelOffset?: number;
+    bevelSegments?: number;
+    billboard?: boolean;
+}
+declare const TextMemo: React.NamedExoticComponent<TextProps>;
+export default TextMemo;