react 15.0.2-alpha.1 → 15.0.2

package/lib/PanResponder.js

@@ -1,362 +0,0 @@
-/**
- * @providesModule PanResponder
- */
-
-'use strict';
-
-var TouchHistoryMath = require('./TouchHistoryMath');
-
-var currentCentroidXOfTouchesChangedAfter = TouchHistoryMath.currentCentroidXOfTouchesChangedAfter;
-var currentCentroidYOfTouchesChangedAfter = TouchHistoryMath.currentCentroidYOfTouchesChangedAfter;
-var previousCentroidXOfTouchesChangedAfter = TouchHistoryMath.previousCentroidXOfTouchesChangedAfter;
-var previousCentroidYOfTouchesChangedAfter = TouchHistoryMath.previousCentroidYOfTouchesChangedAfter;
-var currentCentroidX = TouchHistoryMath.currentCentroidX;
-var currentCentroidY = TouchHistoryMath.currentCentroidY;
-
-/**
- * `PanResponder` reconciles several touches into a single gesture. It makes
- * single-touch gestures resilient to extra touches, and can be used to
- * recognize simple multi-touch gestures.
- *
- * It provides a predictable wrapper of the responder handlers provided by the
- * [gesture responder system](docs/gesture-responder-system.html).
- * For each handler, it provides a new `gestureState` object alongside the
- * native event object:
- *
- * ```
- * onPanResponderMove: (event, gestureState) => {}
- * ```
- *
- * A native event is a synthetic touch event with the following form:
- *
- *  - `nativeEvent`
- *      + `changedTouches` - Array of all touch events that have changed since the last event
- *      + `identifier` - The ID of the touch
- *      + `locationX` - The X position of the touch, relative to the element
- *      + `locationY` - The Y position of the touch, relative to the element
- *      + `pageX` - The X position of the touch, relative to the root element
- *      + `pageY` - The Y position of the touch, relative to the root element
- *      + `target` - The node id of the element receiving the touch event
- *      + `timestamp` - A time identifier for the touch, useful for velocity calculation
- *      + `touches` - Array of all current touches on the screen
- *
- * A `gestureState` object has the following:
- *
- *  - `stateID` - ID of the gestureState- persisted as long as there at least
- *     one touch on screen
- *  - `moveX` - the latest screen coordinates of the recently-moved touch
- *  - `moveY` - the latest screen coordinates of the recently-moved touch
- *  - `x0` - the screen coordinates of the responder grant
- *  - `y0` - the screen coordinates of the responder grant
- *  - `dx` - accumulated distance of the gesture since the touch started
- *  - `dy` - accumulated distance of the gesture since the touch started
- *  - `vx` - current velocity of the gesture
- *  - `vy` - current velocity of the gesture
- *  - `numberActiveTouches` - Number of touches currently on screen
- *
- * ### Basic Usage
- *
- * ```
- *   componentWillMount: function() {
- *     this._panResponder = PanResponder.create({
- *       // Ask to be the responder:
- *       onStartShouldSetPanResponder: (evt, gestureState) => true,
- *       onStartShouldSetPanResponderCapture: (evt, gestureState) => true,
- *       onMoveShouldSetPanResponder: (evt, gestureState) => true,
- *       onMoveShouldSetPanResponderCapture: (evt, gestureState) => true,
- *
- *       onPanResponderGrant: (evt, gestureState) => {
- *         // The guesture has started. Show visual feedback so the user knows
- *         // what is happening!
- *
- *         // gestureState.{x,y}0 will be set to zero now
- *       },
- *       onPanResponderMove: (evt, gestureState) => {
- *         // The most recent move distance is gestureState.move{X,Y}
- *
- *         // The accumulated gesture distance since becoming responder is
- *         // gestureState.d{x,y}
- *       },
- *       onPanResponderTerminationRequest: (evt, gestureState) => true,
- *       onPanResponderRelease: (evt, gestureState) => {
- *         // The user has released all touches while this view is the
- *         // responder. This typically means a gesture has succeeded
- *       },
- *       onPanResponderTerminate: (evt, gestureState) => {
- *         // Another component has become the responder, so this gesture
- *         // should be cancelled
- *       },
- *       onShouldBlockNativeResponder: (evt, gestureState) => {
- *         // Returns whether this component should block native components from becoming the JS
- *         // responder. Returns true by default. Is currently only supported on android.
- *         return true;
- *       },
- *     });
- *   },
- *
- *   render: function() {
- *     return (
- *       <View {...this._panResponder.panHandlers} />
- *     );
- *   },
- *
- * ```
- *
- * ### Working Example
- *
- * To see it in action, try the
- * [PanResponder example in UIExplorer](https://github.com/facebook/react-native/blob/master/Examples/UIExplorer/PanResponderExample.js)
- */
-
-var PanResponder = {
-
-  /**
-   *
-   * A graphical explanation of the touch data flow:
-   *
-   * +----------------------------+             +--------------------------------+
-   * | ResponderTouchHistoryStore |             |TouchHistoryMath                |
-   * +----------------------------+             +----------+---------------------+
-   * |Global store of touchHistory|             |Allocation-less math util       |
-   * |including activeness, start |             |on touch history (centroids     |
-   * |position, prev/cur position.|             |and multitouch movement etc)    |
-   * |                            |             |                                |
-   * +----^-----------------------+             +----^---------------------------+
-   *      |                                          |
-   *      | (records relevant history                |
-   *      |  of touches relevant for                 |
-   *      |  implementing higher level               |
-   *      |  gestures)                               |
-   *      |                                          |
-   * +----+-----------------------+             +----|---------------------------+
-   * | ResponderEventPlugin       |             |    |   Your App/Component      |
-   * +----------------------------+             +----|---------------------------+
-   * |Negotiates which view gets  | Low level   |    |             High level    |
-   * |onResponderMove events.     | events w/   |  +-+-------+     events w/     |
-   * |Also records history into   | touchHistory|  |   Pan   |     multitouch +  |
-   * |ResponderTouchHistoryStore. +---------------->Responder+-----> accumulative|
-   * +----------------------------+ attached to |  |         |     distance and  |
-   *                                 each event |  +---------+     velocity.     |
-   *                                            |                                |
-   *                                            |                                |
-   *                                            +--------------------------------+
-   *
-   *
-   *
-   * Gesture that calculates cumulative movement over time in a way that just
-   * "does the right thing" for multiple touches. The "right thing" is very
-   * nuanced. When moving two touches in opposite directions, the cumulative
-   * distance is zero in each dimension. When two touches move in parallel five
-   * pixels in the same direction, the cumulative distance is five, not ten. If
-   * two touches start, one moves five in a direction, then stops and the other
-   * touch moves fives in the same direction, the cumulative distance is ten.
-   *
-   * This logic requires a kind of processing of time "clusters" of touch events
-   * so that two touch moves that essentially occur in parallel but move every
-   * other frame respectively, are considered part of the same movement.
-   *
-   * Explanation of some of the non-obvious fields:
-   *
-   * - moveX/moveY: If no move event has been observed, then `(moveX, moveY)` is
-   *   invalid. If a move event has been observed, `(moveX, moveY)` is the
-   *   centroid of the most recently moved "cluster" of active touches.
-   *   (Currently all move have the same timeStamp, but later we should add some
-   *   threshold for what is considered to be "moving"). If a palm is
-   *   accidentally counted as a touch, but a finger is moving greatly, the palm
-   *   will move slightly, but we only want to count the single moving touch.
-   * - x0/y0: Centroid location (non-cumulative) at the time of becoming
-   *   responder.
-   * - dx/dy: Cumulative touch distance - not the same thing as sum of each touch
-   *   distance. Accounts for touch moves that are clustered together in time,
-   *   moving the same direction. Only valid when currently responder (otherwise,
-   *   it only represents the drag distance below the threshold).
-   * - vx/vy: Velocity.
-   */
-
-  _initializeGestureState: function (gestureState) {
-    gestureState.moveX = 0;
-    gestureState.moveY = 0;
-    gestureState.x0 = 0;
-    gestureState.y0 = 0;
-    gestureState.dx = 0;
-    gestureState.dy = 0;
-    gestureState.vx = 0;
-    gestureState.vy = 0;
-    gestureState.numberActiveTouches = 0;
-    // All `gestureState` accounts for timeStamps up until:
-    gestureState._accountsForMovesUpTo = 0;
-  },
-
-  /**
-   * This is nuanced and is necessary. It is incorrect to continuously take all
-   * active *and* recently moved touches, find the centroid, and track how that
-   * result changes over time. Instead, we must take all recently moved
-   * touches, and calculate how the centroid has changed just for those
-   * recently moved touches, and append that change to an accumulator. This is
-   * to (at least) handle the case where the user is moving three fingers, and
-   * then one of the fingers stops but the other two continue.
-   *
-   * This is very different than taking all of the recently moved touches and
-   * storing their centroid as `dx/dy`. For correctness, we must *accumulate
-   * changes* in the centroid of recently moved touches.
-   *
-   * There is also some nuance with how we handle multiple moved touches in a
-   * single event. With the way `ReactNativeEventEmitter` dispatches touches as
-   * individual events, multiple touches generate two 'move' events, each of
-   * them triggering `onResponderMove`. But with the way `PanResponder` works,
-   * all of the gesture inference is performed on the first dispatch, since it
-   * looks at all of the touches (even the ones for which there hasn't been a
-   * native dispatch yet). Therefore, `PanResponder` does not call
-   * `onResponderMove` passed the first dispatch. This diverges from the
-   * typical responder callback pattern (without using `PanResponder`), but
-   * avoids more dispatches than necessary.
-   */
-  _updateGestureStateOnMove: function (gestureState, touchHistory) {
-    gestureState.numberActiveTouches = touchHistory.numberActiveTouches;
-    gestureState.moveX = currentCentroidXOfTouchesChangedAfter(touchHistory, gestureState._accountsForMovesUpTo);
-    gestureState.moveY = currentCentroidYOfTouchesChangedAfter(touchHistory, gestureState._accountsForMovesUpTo);
-    var movedAfter = gestureState._accountsForMovesUpTo;
-    var prevX = previousCentroidXOfTouchesChangedAfter(touchHistory, movedAfter);
-    var x = currentCentroidXOfTouchesChangedAfter(touchHistory, movedAfter);
-    var prevY = previousCentroidYOfTouchesChangedAfter(touchHistory, movedAfter);
-    var y = currentCentroidYOfTouchesChangedAfter(touchHistory, movedAfter);
-    var nextDX = gestureState.dx + (x - prevX);
-    var nextDY = gestureState.dy + (y - prevY);
-
-    // TODO: This must be filtered intelligently.
-    var dt = touchHistory.mostRecentTimeStamp - gestureState._accountsForMovesUpTo;
-    gestureState.vx = (nextDX - gestureState.dx) / dt;
-    gestureState.vy = (nextDY - gestureState.dy) / dt;
-
-    gestureState.dx = nextDX;
-    gestureState.dy = nextDY;
-    gestureState._accountsForMovesUpTo = touchHistory.mostRecentTimeStamp;
-  },
-
-  /**
-   * @param {object} config Enhanced versions of all of the responder callbacks
-   * that provide not only the typical `ResponderSyntheticEvent`, but also the
-   * `PanResponder` gesture state.  Simply replace the word `Responder` with
-   * `PanResponder` in each of the typical `onResponder*` callbacks. For
-   * example, the `config` object would look like:
-   *
-   *  - `onMoveShouldSetPanResponder: (e, gestureState) => {...}`
-   *  - `onMoveShouldSetPanResponderCapture: (e, gestureState) => {...}`
-   *  - `onStartShouldSetPanResponder: (e, gestureState) => {...}`
-   *  - `onStartShouldSetPanResponderCapture: (e, gestureState) => {...}`
-   *  - `onPanResponderReject: (e, gestureState) => {...}`
-   *  - `onPanResponderGrant: (e, gestureState) => {...}`
-   *  - `onPanResponderStart: (e, gestureState) => {...}`
-   *  - `onPanResponderEnd: (e, gestureState) => {...}`
-   *  - `onPanResponderRelease: (e, gestureState) => {...}`
-   *  - `onPanResponderMove: (e, gestureState) => {...}`
-   *  - `onPanResponderTerminate: (e, gestureState) => {...}`
-   *  - `onPanResponderTerminationRequest: (e, gestureState) => {...}`
-   *  - `onShouldBlockNativeResponder: (e, gestureState) => {...}`
-   *
-   *  In general, for events that have capture equivalents, we update the
-   *  gestureState once in the capture phase and can use it in the bubble phase
-   *  as well.
-   *
-   *  Be careful with onStartShould* callbacks. They only reflect updated
-   *  `gestureState` for start/end events that bubble/capture to the Node.
-   *  Once the node is the responder, you can rely on every start/end event
-   *  being processed by the gesture and `gestureState` being updated
-   *  accordingly. (numberActiveTouches) may not be totally accurate unless you
-   *  are the responder.
-   */
-  create: function (config) {
-    var gestureState = {
-      // Useful for debugging
-      stateID: Math.random()
-    };
-    PanResponder._initializeGestureState(gestureState);
-    var panHandlers = {
-      onStartShouldSetResponder: function (e) {
-        return config.onStartShouldSetPanResponder === undefined ? false : config.onStartShouldSetPanResponder(e, gestureState);
-      },
-      onMoveShouldSetResponder: function (e) {
-        return config.onMoveShouldSetPanResponder === undefined ? false : config.onMoveShouldSetPanResponder(e, gestureState);
-      },
-      onStartShouldSetResponderCapture: function (e) {
-        // TODO: Actually, we should reinitialize the state any time
-        // touches.length increases from 0 active to > 0 active.
-        if (e.nativeEvent.touches.length === 1) {
-          PanResponder._initializeGestureState(gestureState);
-        }
-        gestureState.numberActiveTouches = e.touchHistory.numberActiveTouches;
-        return config.onStartShouldSetPanResponderCapture !== undefined ? config.onStartShouldSetPanResponderCapture(e, gestureState) : false;
-      },
-
-      onMoveShouldSetResponderCapture: function (e) {
-        var touchHistory = e.touchHistory;
-        // Responder system incorrectly dispatches should* to current responder
-        // Filter out any touch moves past the first one - we would have
-        // already processed multi-touch geometry during the first event.
-        if (gestureState._accountsForMovesUpTo === touchHistory.mostRecentTimeStamp) {
-          return false;
-        }
-        PanResponder._updateGestureStateOnMove(gestureState, touchHistory);
-        return config.onMoveShouldSetPanResponderCapture ? config.onMoveShouldSetPanResponderCapture(e, gestureState) : false;
-      },
-
-      onResponderGrant: function (e) {
-        gestureState.x0 = currentCentroidX(e.touchHistory);
-        gestureState.y0 = currentCentroidY(e.touchHistory);
-        gestureState.dx = 0;
-        gestureState.dy = 0;
-        if (config.onPanResponderGrant) config.onPanResponderGrant(e, gestureState);
-        // TODO: t7467124 investigate if this can be removed
-        return config.onShouldBlockNativeResponder === undefined ? true : config.onShouldBlockNativeResponder();
-      },
-
-      onResponderReject: function (e) {
-        if (config.onPanResponderReject) config.onPanResponderReject(e, gestureState);
-      },
-
-      onResponderRelease: function (e) {
-        if (config.onPanResponderRelease) config.onPanResponderRelease(e, gestureState);
-        PanResponder._initializeGestureState(gestureState);
-      },
-
-      onResponderStart: function (e) {
-        var touchHistory = e.touchHistory;
-        gestureState.numberActiveTouches = touchHistory.numberActiveTouches;
-        if (config.onPanResponderStart) config.onPanResponderStart(e, gestureState);
-      },
-
-      onResponderMove: function (e) {
-        var touchHistory = e.touchHistory;
-        // Guard against the dispatch of two touch moves when there are two
-        // simultaneously changed touches.
-        if (gestureState._accountsForMovesUpTo === touchHistory.mostRecentTimeStamp) {
-          return;
-        }
-        // Filter out any touch moves past the first one - we would have
-        // already processed multi-touch geometry during the first event.
-        PanResponder._updateGestureStateOnMove(gestureState, touchHistory);
-        if (config.onPanResponderMove) config.onPanResponderMove(e, gestureState);
-      },
-
-      onResponderEnd: function (e) {
-        var touchHistory = e.touchHistory;
-        gestureState.numberActiveTouches = touchHistory.numberActiveTouches;
-        if (config.onPanResponderEnd) config.onPanResponderEnd(e, gestureState);
-      },
-
-      onResponderTerminate: function (e) {
-        if (config.onPanResponderTerminate) {
-          config.onPanResponderTerminate(e, gestureState);
-        }
-        PanResponder._initializeGestureState(gestureState);
-      },
-
-      onResponderTerminationRequest: function (e) {
-        return config.onPanResponderTerminationRequest === undefined ? true : config.onPanResponderTerminationRequest(e, gestureState);
-      }
-    };
-    return { panHandlers: panHandlers };
-  }
-};
-
-module.exports = PanResponder;

package/lib/ReactNativeGlobalInteractionHandler.js

@@ -1,33 +0,0 @@
-/**
- * Copyright (c) 2015-present, Facebook, Inc.
- * All rights reserved.
- *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
- *
- * @providesModule ReactNativeGlobalInteractionHandler
- * 
- */
-'use strict';
-
-var InteractionManager = require('InteractionManager');
-
-// Interaction handle is created/cleared when responder is granted or
-// released/terminated.
-var interactionHandle = null;
-
-var ReactNativeGlobalInteractionHandler = {
-  onChange: function (numberActiveTouches) {
-    if (numberActiveTouches === 0) {
-      if (interactionHandle) {
-        InteractionManager.clearInteractionHandle(interactionHandle);
-        interactionHandle = null;
-      }
-    } else if (!interactionHandle) {
-      interactionHandle = InteractionManager.createInteractionHandle();
-    }
-  }
-};
-
-module.exports = ReactNativeGlobalInteractionHandler;

package/lib/ReactPropTransferer.js

@@ -1,109 +0,0 @@
-/**
- * Copyright 2013-present, Facebook, Inc.
- * All rights reserved.
- *
- * This source code is licensed under the BSD-style license found in the
- * LICENSE file in the root directory of this source tree. An additional grant
- * of patent rights can be found in the PATENTS file in the same directory.
- *
- * @providesModule ReactPropTransferer
- */
-
-'use strict';
-
-var _assign = require('object-assign');
-
-var emptyFunction = require('fbjs/lib/emptyFunction');
-var joinClasses = require('fbjs/lib/joinClasses');
-
-/**
- * Creates a transfer strategy that will merge prop values using the supplied
- * `mergeStrategy`. If a prop was previously unset, this just sets it.
- *
- * @param {function} mergeStrategy
- * @return {function}
- */
-function createTransferStrategy(mergeStrategy) {
-  return function (props, key, value) {
-    if (!props.hasOwnProperty(key)) {
-      props[key] = value;
-    } else {
-      props[key] = mergeStrategy(props[key], value);
-    }
-  };
-}
-
-var transferStrategyMerge = createTransferStrategy(function (a, b) {
-  // `merge` overrides the first object's (`props[key]` above) keys using the
-  // second object's (`value`) keys. An object's style's existing `propA` would
-  // get overridden. Flip the order here.
-  return _assign({}, b, a);
-});
-
-/**
- * Transfer strategies dictate how props are transferred by `transferPropsTo`.
- * NOTE: if you add any more exceptions to this list you should be sure to
- * update `cloneWithProps()` accordingly.
- */
-var TransferStrategies = {
-  /**
-   * Never transfer `children`.
-   */
-  children: emptyFunction,
-  /**
-   * Transfer the `className` prop by merging them.
-   */
-  className: createTransferStrategy(joinClasses),
-  /**
-   * Transfer the `style` prop (which is an object) by merging them.
-   */
-  style: transferStrategyMerge
-};
-
-/**
- * Mutates the first argument by transferring the properties from the second
- * argument.
- *
- * @param {object} props
- * @param {object} newProps
- * @return {object}
- */
-function transferInto(props, newProps) {
-  for (var thisKey in newProps) {
-    if (!newProps.hasOwnProperty(thisKey)) {
-      continue;
-    }
-
-    var transferStrategy = TransferStrategies[thisKey];
-
-    if (transferStrategy && TransferStrategies.hasOwnProperty(thisKey)) {
-      transferStrategy(props, thisKey, newProps[thisKey]);
-    } else if (!props.hasOwnProperty(thisKey)) {
-      props[thisKey] = newProps[thisKey];
-    }
-  }
-  return props;
-}
-
-/**
- * ReactPropTransferer are capable of transferring props to another component
- * using a `transferPropsTo` method.
- *
- * @class ReactPropTransferer
- */
-var ReactPropTransferer = {
-
-  /**
-   * Merge two props objects using TransferStrategies.
-   *
-   * @param {object} oldProps original props (they take precedence)
-   * @param {object} newProps new props to merge in
-   * @return {object} a new object containing both sets of props merged.
-   */
-  mergeProps: function (oldProps, newProps) {
-    return transferInto(_assign({}, oldProps), newProps);
-  }
-
-};
-
-module.exports = ReactPropTransferer;