react 15.3.1 → 15.4.0-rc.2

package/lib/ReactNative.js

@@ -1,71 +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 ReactNative
- * 
- */
-'use strict';
-
-// Require ReactNativeDefaultInjection first for its side effects of setting up
-// the JS environment
-
-var ReactNativeComponentTree = require('./ReactNativeComponentTree');
-var ReactNativeDefaultInjection = require('./ReactNativeDefaultInjection');
-
-var ReactElement = require('./ReactElement');
-var ReactNativeMount = require('./ReactNativeMount');
-var ReactUpdates = require('./ReactUpdates');
-
-var findNodeHandle = require('./findNodeHandle');
-
-ReactNativeDefaultInjection.inject();
-
-var render = function (element, mountInto, callback) {
-  return ReactNativeMount.renderComponent(element, mountInto, callback);
-};
-
-var ReactNative = {
-  hasReactNativeInitialized: false,
-  findNodeHandle: findNodeHandle,
-  render: render,
-  unmountComponentAtNode: ReactNativeMount.unmountComponentAtNode,
-
-  /* eslint-disable camelcase */
-  unstable_batchedUpdates: ReactUpdates.batchedUpdates,
-  /* eslint-enable camelcase */
-
-  unmountComponentAtNodeAndRemoveContainer: ReactNativeMount.unmountComponentAtNodeAndRemoveContainer
-};
-
-// Inject the runtime into a devtools global hook regardless of browser.
-// Allows for debugging when the hook is injected on the page.
-/* globals __REACT_DEVTOOLS_GLOBAL_HOOK__ */
-if (typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ !== 'undefined' && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject === 'function') {
-  __REACT_DEVTOOLS_GLOBAL_HOOK__.inject({
-    ComponentTree: {
-      getClosestInstanceFromNode: function (node) {
-        return ReactNativeComponentTree.getClosestInstanceFromNode(node);
-      },
-      getNodeFromInstance: function (inst) {
-        // inst is an internal instance (but could be a composite)
-        while (inst._renderedComponent) {
-          inst = inst._renderedComponent;
-        }
-        if (inst) {
-          return ReactNativeComponentTree.getNodeFromInstance(inst);
-        } else {
-          return null;
-        }
-      }
-    },
-    Mount: ReactNativeMount,
-    Reconciler: require('./ReactReconciler')
-  });
-}
-
-module.exports = ReactNative;

package/lib/ReactNativeAttributePayload.js

@@ -1,371 +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 ReactNativeAttributePayload
- * 
- */
-'use strict';
-
-var ReactNativePropRegistry = require('./ReactNativePropRegistry');
-
-var deepDiffer = require('react-native/lib/deepDiffer');
-var flattenStyle = require('react-native/lib/flattenStyle');
-
-var emptyObject = {};
-
-/**
- * Create a payload that contains all the updates between two sets of props.
- *
- * These helpers are all encapsulated into a single module, because they use
- * mutation as a performance optimization which leads to subtle shared
- * dependencies between the code paths. To avoid this mutable state leaking
- * across modules, I've kept them isolated to this module.
- */
-
-/*| boolean*/
-
-
-// Tracks removed keys
-var removedKeys = null;
-var removedKeyCount = 0;
-
-function defaultDiffer(prevProp, nextProp) {
-  if (typeof nextProp !== 'object' || nextProp === null) {
-    // Scalars have already been checked for equality
-    return true;
-  } else {
-    // For objects and arrays, the default diffing algorithm is a deep compare
-    return deepDiffer(prevProp, nextProp);
-  }
-}
-
-function resolveObject(idOrObject) {
-  if (typeof idOrObject === 'number') {
-    return ReactNativePropRegistry.getByID(idOrObject);
-  }
-  return idOrObject;
-}
-
-function restoreDeletedValuesInNestedArray(updatePayload, node, validAttributes) {
-  if (Array.isArray(node)) {
-    var i = node.length;
-    while (i-- && removedKeyCount > 0) {
-      restoreDeletedValuesInNestedArray(updatePayload, node[i], validAttributes);
-    }
-  } else if (node && removedKeyCount > 0) {
-    var obj = resolveObject(node);
-    for (var propKey in removedKeys) {
-      if (!removedKeys[propKey]) {
-        continue;
-      }
-      var nextProp = obj[propKey];
-      if (nextProp === undefined) {
-        continue;
-      }
-
-      var attributeConfig = validAttributes[propKey];
-      if (!attributeConfig) {
-        continue; // not a valid native prop
-      }
-
-      if (typeof nextProp === 'function') {
-        nextProp = true;
-      }
-      if (typeof nextProp === 'undefined') {
-        nextProp = null;
-      }
-
-      if (typeof attributeConfig !== 'object') {
-        // case: !Object is the default case
-        updatePayload[propKey] = nextProp;
-      } else if (typeof attributeConfig.diff === 'function' || typeof attributeConfig.process === 'function') {
-        // case: CustomAttributeConfiguration
-        var nextValue = typeof attributeConfig.process === 'function' ? attributeConfig.process(nextProp) : nextProp;
-        updatePayload[propKey] = nextValue;
-      }
-      removedKeys[propKey] = false;
-      removedKeyCount--;
-    }
-  }
-}
-
-function diffNestedArrayProperty(updatePayload, prevArray, nextArray, validAttributes) {
-  var minLength = prevArray.length < nextArray.length ? prevArray.length : nextArray.length;
-  var i;
-  for (i = 0; i < minLength; i++) {
-    // Diff any items in the array in the forward direction. Repeated keys
-    // will be overwritten by later values.
-    updatePayload = diffNestedProperty(updatePayload, prevArray[i], nextArray[i], validAttributes);
-  }
-  for (; i < prevArray.length; i++) {
-    // Clear out all remaining properties.
-    updatePayload = clearNestedProperty(updatePayload, prevArray[i], validAttributes);
-  }
-  for (; i < nextArray.length; i++) {
-    // Add all remaining properties.
-    updatePayload = addNestedProperty(updatePayload, nextArray[i], validAttributes);
-  }
-  return updatePayload;
-}
-
-function diffNestedProperty(updatePayload, prevProp, nextProp, validAttributes) {
-
-  if (!updatePayload && prevProp === nextProp) {
-    // If no properties have been added, then we can bail out quickly on object
-    // equality.
-    return updatePayload;
-  }
-
-  if (!prevProp || !nextProp) {
-    if (nextProp) {
-      return addNestedProperty(updatePayload, nextProp, validAttributes);
-    }
-    if (prevProp) {
-      return clearNestedProperty(updatePayload, prevProp, validAttributes);
-    }
-    return updatePayload;
-  }
-
-  if (!Array.isArray(prevProp) && !Array.isArray(nextProp)) {
-    // Both are leaves, we can diff the leaves.
-    return diffProperties(updatePayload, resolveObject(prevProp), resolveObject(nextProp), validAttributes);
-  }
-
-  if (Array.isArray(prevProp) && Array.isArray(nextProp)) {
-    // Both are arrays, we can diff the arrays.
-    return diffNestedArrayProperty(updatePayload, prevProp, nextProp, validAttributes);
-  }
-
-  if (Array.isArray(prevProp)) {
-    return diffProperties(updatePayload,
-    // $FlowFixMe - We know that this is always an object when the input is.
-    flattenStyle(prevProp),
-    // $FlowFixMe - We know that this isn't an array because of above flow.
-    resolveObject(nextProp), validAttributes);
-  }
-
-  return diffProperties(updatePayload, resolveObject(prevProp),
-  // $FlowFixMe - We know that this is always an object when the input is.
-  flattenStyle(nextProp), validAttributes);
-}
-
-/**
- * addNestedProperty takes a single set of props and valid attribute
- * attribute configurations. It processes each prop and adds it to the
- * updatePayload.
- */
-function addNestedProperty(updatePayload, nextProp, validAttributes) {
-  if (!nextProp) {
-    return updatePayload;
-  }
-
-  if (!Array.isArray(nextProp)) {
-    // Add each property of the leaf.
-    return addProperties(updatePayload, resolveObject(nextProp), validAttributes);
-  }
-
-  for (var i = 0; i < nextProp.length; i++) {
-    // Add all the properties of the array.
-    updatePayload = addNestedProperty(updatePayload, nextProp[i], validAttributes);
-  }
-
-  return updatePayload;
-}
-
-/**
- * clearNestedProperty takes a single set of props and valid attributes. It
- * adds a null sentinel to the updatePayload, for each prop key.
- */
-function clearNestedProperty(updatePayload, prevProp, validAttributes) {
-  if (!prevProp) {
-    return updatePayload;
-  }
-
-  if (!Array.isArray(prevProp)) {
-    // Add each property of the leaf.
-    return clearProperties(updatePayload, resolveObject(prevProp), validAttributes);
-  }
-
-  for (var i = 0; i < prevProp.length; i++) {
-    // Add all the properties of the array.
-    updatePayload = clearNestedProperty(updatePayload, prevProp[i], validAttributes);
-  }
-  return updatePayload;
-}
-
-/**
- * diffProperties takes two sets of props and a set of valid attributes
- * and write to updatePayload the values that changed or were deleted.
- * If no updatePayload is provided, a new one is created and returned if
- * anything changed.
- */
-function diffProperties(updatePayload, prevProps, nextProps, validAttributes) {
-  var attributeConfig;
-  var nextProp;
-  var prevProp;
-
-  for (var propKey in nextProps) {
-    attributeConfig = validAttributes[propKey];
-    if (!attributeConfig) {
-      continue; // not a valid native prop
-    }
-
-    prevProp = prevProps[propKey];
-    nextProp = nextProps[propKey];
-
-    // functions are converted to booleans as markers that the associated
-    // events should be sent from native.
-    if (typeof nextProp === 'function') {
-      nextProp = true;
-      // If nextProp is not a function, then don't bother changing prevProp
-      // since nextProp will win and go into the updatePayload regardless.
-      if (typeof prevProp === 'function') {
-        prevProp = true;
-      }
-    }
-
-    // An explicit value of undefined is treated as a null because it overrides
-    // any other preceeding value.
-    if (typeof nextProp === 'undefined') {
-      nextProp = null;
-      if (typeof prevProp === 'undefined') {
-        prevProp = null;
-      }
-    }
-
-    if (removedKeys) {
-      removedKeys[propKey] = false;
-    }
-
-    if (updatePayload && updatePayload[propKey] !== undefined) {
-      // Something else already triggered an update to this key because another
-      // value diffed. Since we're now later in the nested arrays our value is
-      // more important so we need to calculate it and override the existing
-      // value. It doesn't matter if nothing changed, we'll set it anyway.
-
-      // Pattern match on: attributeConfig
-      if (typeof attributeConfig !== 'object') {
-        // case: !Object is the default case
-        updatePayload[propKey] = nextProp;
-      } else if (typeof attributeConfig.diff === 'function' || typeof attributeConfig.process === 'function') {
-        // case: CustomAttributeConfiguration
-        var nextValue = typeof attributeConfig.process === 'function' ? attributeConfig.process(nextProp) : nextProp;
-        updatePayload[propKey] = nextValue;
-      }
-      continue;
-    }
-
-    if (prevProp === nextProp) {
-      continue; // nothing changed
-    }
-
-    // Pattern match on: attributeConfig
-    if (typeof attributeConfig !== 'object') {
-      // case: !Object is the default case
-      if (defaultDiffer(prevProp, nextProp)) {
-        // a normal leaf has changed
-        (updatePayload || (updatePayload = {}))[propKey] = nextProp;
-      }
-    } else if (typeof attributeConfig.diff === 'function' || typeof attributeConfig.process === 'function') {
-      // case: CustomAttributeConfiguration
-      var shouldUpdate = prevProp === undefined || (typeof attributeConfig.diff === 'function' ? attributeConfig.diff(prevProp, nextProp) : defaultDiffer(prevProp, nextProp));
-      if (shouldUpdate) {
-        nextValue = typeof attributeConfig.process === 'function' ? attributeConfig.process(nextProp) : nextProp;
-        (updatePayload || (updatePayload = {}))[propKey] = nextValue;
-      }
-    } else {
-      // default: fallthrough case when nested properties are defined
-      removedKeys = null;
-      removedKeyCount = 0;
-      // We think that attributeConfig is not CustomAttributeConfiguration at
-      // this point so we assume it must be AttributeConfiguration.
-      // $FlowFixMe
-      updatePayload = diffNestedProperty(updatePayload, prevProp, nextProp, attributeConfig);
-      if (removedKeyCount > 0 && updatePayload) {
-        restoreDeletedValuesInNestedArray(updatePayload, nextProp, attributeConfig);
-        removedKeys = null;
-      }
-    }
-  }
-
-  // Also iterate through all the previous props to catch any that have been
-  // removed and make sure native gets the signal so it can reset them to the
-  // default.
-  for (propKey in prevProps) {
-    if (nextProps[propKey] !== undefined) {
-      continue; // we've already covered this key in the previous pass
-    }
-    attributeConfig = validAttributes[propKey];
-    if (!attributeConfig) {
-      continue; // not a valid native prop
-    }
-
-    if (updatePayload && updatePayload[propKey] !== undefined) {
-      // This was already updated to a diff result earlier.
-      continue;
-    }
-
-    prevProp = prevProps[propKey];
-    if (prevProp === undefined) {
-      continue; // was already empty anyway
-    }
-    // Pattern match on: attributeConfig
-    if (typeof attributeConfig !== 'object' || typeof attributeConfig.diff === 'function' || typeof attributeConfig.process === 'function') {
-
-      // case: CustomAttributeConfiguration | !Object
-      // Flag the leaf property for removal by sending a sentinel.
-      (updatePayload || (updatePayload = {}))[propKey] = null;
-      if (!removedKeys) {
-        removedKeys = {};
-      }
-      if (!removedKeys[propKey]) {
-        removedKeys[propKey] = true;
-        removedKeyCount++;
-      }
-    } else {
-      // default:
-      // This is a nested attribute configuration where all the properties
-      // were removed so we need to go through and clear out all of them.
-      updatePayload = clearNestedProperty(updatePayload, prevProp, attributeConfig);
-    }
-  }
-  return updatePayload;
-}
-
-/**
- * addProperties adds all the valid props to the payload after being processed.
- */
-function addProperties(updatePayload, props, validAttributes) {
-  // TODO: Fast path
-  return diffProperties(updatePayload, emptyObject, props, validAttributes);
-}
-
-/**
- * clearProperties clears all the previous props by adding a null sentinel
- * to the payload for each valid key.
- */
-function clearProperties(updatePayload, prevProps, validAttributes) {
-  // TODO: Fast path
-  return diffProperties(updatePayload, prevProps, emptyObject, validAttributes);
-}
-
-var ReactNativeAttributePayload = {
-
-  create: function (props, validAttributes) {
-    return addProperties(null, // updatePayload
-    props, validAttributes);
-  },
-
-  diff: function (prevProps, nextProps, validAttributes) {
-    return diffProperties(null, // updatePayload
-    prevProps, nextProps, validAttributes);
-  }
-
-};
-
-module.exports = ReactNativeAttributePayload;

package/lib/ReactNativeBaseComponent.js

@@ -1,198 +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 ReactNativeBaseComponent
- * 
- */
-'use strict';
-
-var _assign = require('object-assign');
-
-var NativeMethodsMixin = require('./NativeMethodsMixin');
-var ReactNativeAttributePayload = require('./ReactNativeAttributePayload');
-var ReactNativeComponentTree = require('./ReactNativeComponentTree');
-var ReactNativeEventEmitter = require('./ReactNativeEventEmitter');
-var ReactNativeTagHandles = require('./ReactNativeTagHandles');
-var ReactMultiChild = require('./ReactMultiChild');
-var UIManager = require('react-native/lib/UIManager');
-
-var deepFreezeAndThrowOnMutationInDev = require('react-native/lib/deepFreezeAndThrowOnMutationInDev');
-
-var registrationNames = ReactNativeEventEmitter.registrationNames;
-var putListener = ReactNativeEventEmitter.putListener;
-var deleteListener = ReactNativeEventEmitter.deleteListener;
-var deleteAllListeners = ReactNativeEventEmitter.deleteAllListeners;
-
-// require('UIManagerStatTracker').install(); // uncomment to enable
-
-/**
- * @constructor ReactNativeBaseComponent
- * @extends ReactComponent
- * @extends ReactMultiChild
- * @param {!object} UIKit View Configuration.
- */
-var ReactNativeBaseComponent = function (viewConfig) {
-  this.viewConfig = viewConfig;
-};
-
-/**
- * Mixin for containers that contain UIViews. NOTE: markup is rendered markup
- * which is a `viewID` ... see the return value for `mountComponent` !
- */
-ReactNativeBaseComponent.Mixin = {
-  getPublicInstance: function () {
-    // TODO: This should probably use a composite wrapper
-    return this;
-  },
-
-  unmountComponent: function () {
-    ReactNativeComponentTree.uncacheNode(this);
-    deleteAllListeners(this);
-    this.unmountChildren();
-    this._rootNodeID = 0;
-  },
-
-  /**
-   * Every native component is responsible for allocating its own `tag`, and
-   * issuing the native `createView` command. But it is not responsible for
-   * recording the fact that its own `rootNodeID` is associated with a
-   * `nodeHandle`. Only the code that actually adds its `nodeHandle` (`tag`) as
-   * a child of a container can confidently record that in
-   * `ReactNativeTagHandles`.
-   */
-  initializeChildren: function (children, containerTag, transaction, context) {
-    var mountImages = this.mountChildren(children, transaction, context);
-    // In a well balanced tree, half of the nodes are in the bottom row and have
-    // no children - let's avoid calling out to the native bridge for a large
-    // portion of the children.
-    if (mountImages.length) {
-
-      // TODO: Pool these per platform view class. Reusing the `mountImages`
-      // array would likely be a jit deopt.
-      var createdTags = [];
-      for (var i = 0, l = mountImages.length; i < l; i++) {
-        var mountImage = mountImages[i];
-        var childTag = mountImage;
-        createdTags[i] = childTag;
-      }
-      UIManager.setChildren(containerTag, createdTags);
-    }
-  },
-
-  /**
-   * Updates the component's currently mounted representation.
-   *
-   * @param {object} nextElement
-   * @param {ReactReconcileTransaction} transaction
-   * @param {object} context
-   * @internal
-   */
-  receiveComponent: function (nextElement, transaction, context) {
-    var prevElement = this._currentElement;
-    this._currentElement = nextElement;
-
-    if (process.env.NODE_ENV !== 'production') {
-      for (var key in this.viewConfig.validAttributes) {
-        if (nextElement.props.hasOwnProperty(key)) {
-          deepFreezeAndThrowOnMutationInDev(nextElement.props[key]);
-        }
-      }
-    }
-
-    var updatePayload = ReactNativeAttributePayload.diff(prevElement.props, nextElement.props, this.viewConfig.validAttributes);
-
-    if (updatePayload) {
-      UIManager.updateView(this._rootNodeID, this.viewConfig.uiViewClassName, updatePayload);
-    }
-
-    this._reconcileListenersUponUpdate(prevElement.props, nextElement.props);
-    this.updateChildren(nextElement.props.children, transaction, context);
-  },
-
-  /**
-   * @param {object} initialProps Native component props.
-   */
-  _registerListenersUponCreation: function (initialProps) {
-    for (var key in initialProps) {
-      // NOTE: The check for `!props[key]`, is only possible because this method
-      // registers listeners the *first* time a component is created.
-      if (registrationNames[key] && initialProps[key]) {
-        var listener = initialProps[key];
-        putListener(this, key, listener);
-      }
-    }
-  },
-
-  /**
-   * Reconciles event listeners, adding or removing if necessary.
-   * @param {object} prevProps Native component props including events.
-   * @param {object} nextProps Next native component props including events.
-   */
-  _reconcileListenersUponUpdate: function (prevProps, nextProps) {
-    for (var key in nextProps) {
-      if (registrationNames[key] && nextProps[key] !== prevProps[key]) {
-        if (nextProps[key]) {
-          putListener(this, key, nextProps[key]);
-        } else {
-          deleteListener(this, key);
-        }
-      }
-    }
-  },
-
-  /**
-   * Currently this still uses IDs for reconciliation so this can return null.
-   *
-   * @return {null} Null.
-   */
-  getHostNode: function () {
-    return this._rootNodeID;
-  },
-
-  /**
-   * @param {ReactNativeReconcileTransaction} transaction
-   * @param {?ReactNativeBaseComponent} the parent component instance
-   * @param {?object} info about the host container
-   * @param {object} context
-   * @return {string} Unique iOS view tag.
-   */
-  mountComponent: function (transaction, hostParent, hostContainerInfo, context) {
-    var tag = ReactNativeTagHandles.allocateTag();
-
-    this._rootNodeID = tag;
-    this._hostParent = hostParent;
-    this._hostContainerInfo = hostContainerInfo;
-
-    if (process.env.NODE_ENV !== 'production') {
-      for (var key in this.viewConfig.validAttributes) {
-        if (this._currentElement.props.hasOwnProperty(key)) {
-          deepFreezeAndThrowOnMutationInDev(this._currentElement.props[key]);
-        }
-      }
-    }
-
-    var updatePayload = ReactNativeAttributePayload.create(this._currentElement.props, this.viewConfig.validAttributes);
-
-    var nativeTopRootTag = hostContainerInfo._tag;
-    UIManager.createView(tag, this.viewConfig.uiViewClassName, nativeTopRootTag, updatePayload);
-
-    ReactNativeComponentTree.precacheNode(this, tag);
-
-    this._registerListenersUponCreation(this._currentElement.props);
-    this.initializeChildren(this._currentElement.props.children, tag, transaction, context);
-    return tag;
-  }
-};
-
-/**
- * Order of mixins is important. ReactNativeBaseComponent overrides methods in
- * ReactMultiChild.
- */
-_assign(ReactNativeBaseComponent.prototype, ReactMultiChild.Mixin, ReactNativeBaseComponent.Mixin, NativeMethodsMixin);
-
-module.exports = ReactNativeBaseComponent;