react 0.6.3 → 0.9.0-rc1

package/lib/traverseAllChildren.js

@@ -0,0 +1,189 @@
+/**
+ * Copyright 2013 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @providesModule traverseAllChildren
+ */
+
+"use strict";
+
+var ReactInstanceHandles = require("./ReactInstanceHandles");
+var ReactTextComponent = require("./ReactTextComponent");
+
+var invariant = require("./invariant");
+
+var SEPARATOR = ReactInstanceHandles.SEPARATOR;
+var SUBSEPARATOR = ':';
+
+/**
+ * TODO: Test that:
+ * 1. `mapChildren` transforms strings and numbers into `ReactTextComponent`.
+ * 2. it('should fail when supplied duplicate key', function() {
+ * 3. That a single child and an array with one item have the same key pattern.
+ * });
+ */
+
+var userProvidedKeyEscaperLookup = {
+  '=': '=0',
+  '.': '=1',
+  ':': '=2'
+};
+
+var userProvidedKeyEscapeRegex = /[=.:]/g;
+
+function userProvidedKeyEscaper(match) {
+  return userProvidedKeyEscaperLookup[match];
+}
+
+/**
+ * Generate a key string that identifies a component within a set.
+ *
+ * @param {*} component A component that could contain a manual key.
+ * @param {number} index Index that is used if a manual key is not provided.
+ * @return {string}
+ */
+function getComponentKey(component, index) {
+  if (component && component.props && component.props.key != null) {
+    // Explicit key
+    return wrapUserProvidedKey(component.props.key);
+  }
+  // Implicit key determined by the index in the set
+  return index.toString(36);
+}
+
+/**
+ * Escape a component key so that it is safe to use in a reactid.
+ *
+ * @param {*} key Component key to be escaped.
+ * @return {string} An escaped string.
+ */
+function escapeUserProvidedKey(text) {
+  return ('' + text).replace(
+    userProvidedKeyEscapeRegex,
+    userProvidedKeyEscaper
+  );
+}
+
+/**
+ * Wrap a `key` value explicitly provided by the user to distinguish it from
+ * implicitly-generated keys generated by a component's index in its parent.
+ *
+ * @param {string} key Value of a user-provided `key` attribute
+ * @return {string}
+ */
+function wrapUserProvidedKey(key) {
+  return '$' + escapeUserProvidedKey(key);
+}
+
+/**
+ * @param {?*} children Children tree container.
+ * @param {!string} nameSoFar Name of the key path so far.
+ * @param {!number} indexSoFar Number of children encountered until this point.
+ * @param {!function} callback Callback to invoke with each child found.
+ * @param {?*} traverseContext Used to pass information throughout the traversal
+ * process.
+ * @return {!number} The number of children in this subtree.
+ */
+var traverseAllChildrenImpl =
+  function(children, nameSoFar, indexSoFar, callback, traverseContext) {
+    var subtreeCount = 0;  // Count of children found in the current subtree.
+    if (Array.isArray(children)) {
+      for (var i = 0; i < children.length; i++) {
+        var child = children[i];
+        var nextName = (
+          nameSoFar +
+          (nameSoFar ? SUBSEPARATOR : SEPARATOR) +
+          getComponentKey(child, i)
+        );
+        var nextIndex = indexSoFar + subtreeCount;
+        subtreeCount += traverseAllChildrenImpl(
+          child,
+          nextName,
+          nextIndex,
+          callback,
+          traverseContext
+        );
+      }
+    } else {
+      var type = typeof children;
+      var isOnlyChild = nameSoFar === '';
+      // If it's the only child, treat the name as if it was wrapped in an array
+      // so that it's consistent if the number of children grows
+      var storageName =
+        isOnlyChild ? SEPARATOR + getComponentKey(children, 0) : nameSoFar;
+      if (children == null || type === 'boolean') {
+        // All of the above are perceived as null.
+        callback(traverseContext, null, storageName, indexSoFar);
+        subtreeCount = 1;
+      } else if (children.mountComponentIntoNode) {
+        callback(traverseContext, children, storageName, indexSoFar);
+        subtreeCount = 1;
+      } else {
+        if (type === 'object') {
+          ("production" !== process.env.NODE_ENV ? invariant(
+            !children || children.nodeType !== 1,
+            'traverseAllChildren(...): Encountered an invalid child; DOM ' +
+            'elements are not valid children of React components.'
+          ) : invariant(!children || children.nodeType !== 1));
+          for (var key in children) {
+            if (children.hasOwnProperty(key)) {
+              subtreeCount += traverseAllChildrenImpl(
+                children[key],
+                (
+                  nameSoFar + (nameSoFar ? SUBSEPARATOR : SEPARATOR) +
+                  wrapUserProvidedKey(key) + SUBSEPARATOR +
+                  getComponentKey(children[key], 0)
+                ),
+                indexSoFar + subtreeCount,
+                callback,
+                traverseContext
+              );
+            }
+          }
+        } else if (type === 'string') {
+          var normalizedText = new ReactTextComponent(children);
+          callback(traverseContext, normalizedText, storageName, indexSoFar);
+          subtreeCount += 1;
+        } else if (type === 'number') {
+          var normalizedNumber = new ReactTextComponent('' + children);
+          callback(traverseContext, normalizedNumber, storageName, indexSoFar);
+          subtreeCount += 1;
+        }
+      }
+    }
+    return subtreeCount;
+  };
+
+/**
+ * Traverses children that are typically specified as `props.children`, but
+ * might also be specified through attributes:
+ *
+ * - `traverseAllChildren(this.props.children, ...)`
+ * - `traverseAllChildren(this.props.leftPanelChildren, ...)`
+ *
+ * The `traverseContext` is an optional argument that is passed through the
+ * entire traversal. It can be used to store accumulations or anything else that
+ * the callback might find relevant.
+ *
+ * @param {?*} children Children tree object.
+ * @param {!function} callback To invoke upon traversing each child.
+ * @param {?*} traverseContext Context for traversal.
+ */
+function traverseAllChildren(children, callback, traverseContext) {
+  if (children !== null && children !== undefined) {
+    traverseAllChildrenImpl(children, '', 0, callback, traverseContext);
+  }
+}
+
+module.exports = traverseAllChildren;

package/lib/warning.js

@@ -0,0 +1,40 @@
+/**
+ * Copyright 2014 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @providesModule warning
+ */
+
+
+/**
+ * Similar to invariant but only logs a warning if the condition is not met.
+ * This can be used to log issues in development environments in critical
+ * paths. Removing the logging code for production environments will keep the
+ * same logic and follow the same code paths.
+ */
+function warning(condition, format ) {var args=Array.prototype.slice.call(arguments,2);
+  if (format === undefined) {
+    throw new Error(
+      '`warning(condition, format, ...args)` requires a warning ' +
+      'message argument'
+    );
+  }
+
+  if (!condition) {
+    var argIndex = 0;
+    console.warn('Warning: ' + format.replace(/%s/g, function()  {return args[argIndex++];}));
+  }
+}
+
+module.exports = warning;

package/package.json

@@ -1,26 +1,37 @@
 {
   "name": "react",
-  "description": "React is a javascript module implementing a lightweight rules engine to make it easier to work with asynchronous code, by reducing boilerplate code and improving error and exception handling while allowing variable and task dependencies when defining flow.",
-  "version": "0.6.3",
-  "author": "Jeff Barczewski <jeff.barczewski@gmail.com>",
-  "repository": { "type": "git", "url": "http://github.com/jeffbski/react.git" },
-  "bugs" : { "url": "http://github.com/jeffbski/react/issues" },
-  "licenses": [{ "type": "MIT", "url" : "http://github.com/jeffbski/react/raw/master/LICENSE" }],
-  "main": "lib/react",
-  "engines": { "node": ">=0.6" },
-  "dependencies": {
-    "amdefine": "~0.0.2",
-    "eventemitter2": "~0.4.1",
-    "ensure-array": "~0.0.5"
+  "version": "0.9.0-rc1",
+  "keywords": [
+    "react"
+  ],
+  "homepage": "https://github.com/facebook/react/tree/master/npm-react",
+  "bugs": "https://github.com/facebook/react/issues?labels=react-core",
+  "licenses": [
+    {
+      "type": "Apache-2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0"
+    }
+  ],
+  "files": [
+    "README.md",
+    "addons.js",
+    "react.js",
+    "lib/"
+  ],
+  "main": "react.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/facebook/react"
   },
-  "devDependencies": {
-    "requirejs": "~2.0.6",
-    "mocha": "~1.4.2",
-    "chai": "~1.2.0",
-    "jake": "~0.3.16",
-    "Deferred" : "~0.1.1"
+  "engines": {
+    "node": ">=0.10.0"
   },
-  "scripts": {
-    "test": "./node_modules/mocha/bin/mocha ./test/*.mocha.js"
+  "peerDependencies": {
+    "envify": "~1.0.1"
+  },
+  "browserify": {
+    "transform": [
+      "envify"
+    ]
   }
-}
+}

package/react.js

@@ -0,0 +1 @@
+module.exports = require('./lib/React');

package/.npmignore

@@ -1,7 +0,0 @@
-node_modules
-npm-debug.log
-./npmrc
-todo.md
-notes.md
-.DS_Store
-externalDocs

package/.travis.yml

@@ -1,5 +0,0 @@
-language: node_js
-node_js:
-  - 0.6
-  - 0.7
-  - 0.8

package/Jakefile.js

@@ -1,39 +0,0 @@
-'use strict';
-/*global fail:false, complete:false, desc:false, jake:false, namespace:false, task:false */
-
-var path = require('path');
-var child_process = require('child_process');
-
-var REQUIREJS = path.resolve(__dirname, 'node_modules/requirejs/bin/r.js');
-
-desc('Default - build all dist versions');
-task('default', ['dist-all'], function (params) { });
-
-
-function runRequireJs(argStr) {
-  var proc = child_process.spawn(REQUIREJS, argStr.split(' '));
-  proc.stdout.pipe(process.stdout);
-  proc.stderr.pipe(process.stderr);
-  proc.on('exit', function (exitCode) {
-    if (exitCode !== 0) {
-      console.error('Child process exited with error code: %s, exiting', exitCode);
-      process.exit(exitCode);
-    }
-  });
-}
-
-desc('Create core single-file developer dist');
-task('dist', function () {
-  runRequireJs('-o src/dist.build.requirejs out=dist/react.js');
-});
-
-desc('Create full single-file minified dist');
-task('min', function () {
-  runRequireJs('-o src/dist.build.requirejs out=dist/react.min.js optimize=uglify');
-});
-
-desc('Create all dist versions');
-task('dist-all', ['dist', 'min']);
-
-
-

package/LICENSE

@@ -1,19 +0,0 @@
-Copyright (c) 2011 Jeff Barczewski
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/browser-test/dist.html

@@ -1,90 +0,0 @@
-<html>
-<head>
-  <meta charset="utf-8">
-  <title>Mocha Tests</title>
-  <link rel="stylesheet" href="../vendor/mocha/mocha.css" />
-  <script type="text/javascript" src="../vendor/jquery/jquery-1.7.1.js"></script>
-  <script type="text/javascript" src="../vendor/chai/chai.js"></script>
-  <script type="text/javascript" src="../vendor/mocha/mocha.js"></script>
-  <script>mocha.setup('qunit')</script>
-  <script src="../vendor/requirejs/require.min.js"></script>
-  <script type="text/javascript">
-    require.config({
-      baseUrl: "..",
-      packages: [
-        {
-          name: "react",
-          location: "dist",
-          main: "react"
-        }
-      ],
-      paths: {
-        jQuery: "vendor/jquery/jquery-1.7.1",
-        eventemitter2: "dist/react",
-        util: "dist/react",
-        "ensure-array": "dist/react",
-        test: "test"
-      }
-    });
-
-    require(["react", "jQuery"],
-            function (react, jquery) {
-
-      require(["react/sprintf", "react/validate", "react/task", "react/cb-task",
-               "react/vcon", "react/event-manager", "react/input-parser",
-               "react/base-task", "react/ret-task", "util"],
-             function (sprintf, validate, taskUtil, CbTask,
-                       VContext, EventManager, inputParser,
-                       BaseTask, RetTask, util) {
-        // save refs on window for these
-        window.react = react;
-        window.sprintf = sprintf;
-        window.util = util;
-        window.validate = validate;
-        window.taskUtil = taskUtil;
-        window.CbTask = CbTask;
-        window.VContext = VContext;
-        window.EventManager = EventManager;
-        window.inputParser = inputParser;
-        window.BaseTask = BaseTask;
-        window.RetTask = RetTask;
-        window.validate = validate;
-        window.Deferred = jQuery.Deferred;
-        window.Deferred.when = jQuery.when;
-        var testFiles = [
-          "test/ast.mocha",
-          "test/cb-task.mocha",
-          "test/core-deferred.mocha",
-          "test/core-when.mocha",
-          "test/core.mocha",
-          "test/dsl.mocha",
-          "test/event-manager.mocha",
-          "test/exec-options.mocha",
-          "test/finalcb-task.mocha",
-          "test/input-parser.mocha",
-          "test/log-events.mocha",
-          "test/module-use.mocha",
-          "test/promise-auto-resolve.mocha",
-          "test/ret-task.mocha",
-          "test/task.mocha",
-          "test/validate-cb-task.mocha",
-          "test/validate-ret-task.mocha",
-          "test/validate.mocha",
-          "test/vcon.mocha"
-        ];
-        require(testFiles, function () {
-          var runner = mocha.run().on('end', function () {
-            console.log('mocha finished');
-            jQuery("#mocha-result").text('completed');
-          });
-          //mocha.reporters.TAP(runner);
-        });
-      });
-    });
-  </script>
-</head>
-<body>
-  <div id="mocha"></div>
-  <div id="mocha-result"></div>
-</body>
-</html>