{"body":"","parents":["7a0f2d71bbfd6ea03eb239830855d992c1ecb841","ce0704a4913f28f8c135ecf840105d8d773d8c7d"],"patch":"diff --git a\/.gitignore b\/.gitignore\nindex b7e395980c..090d7c3aee 100644\n--- a\/.gitignore\n+++ b\/.gitignore\n@@ -6,11 +6,13 @@ static\n .grunt\n _SpecRunner.html\n build\/\n+.module-cache\n *.gem\n docs\/code\n docs\/_site\n docs\/.sass-cache\n docs\/css\/react.css\n+docs\/js\/.module-cache\n docs\/js\/JSXTransformer.js\n docs\/js\/react.min.js\n docs\/js\/docs.js\ndiff --git a\/bin\/jsx b\/bin\/jsx\nindex ccdb19e668..2a6437d535 100755\n--- a\/bin\/jsx\n+++ b\/bin\/jsx\n@@ -3,7 +3,7 @@\n \n var visitors = require('..\/vendor\/fbtransform\/visitors').transformVisitors;\n var transform = require('..\/vendor\/fbtransform\/lib\/transform').transform;\n-var debranch = require(\"..\/vendor\/woodchipper\").debranch;\n+var propagate = require(\"..\/vendor\/constants\").propagate;\n \n require(\"commoner\").resolve(function(id) {\n var context = this;\n@@ -25,18 +25,12 @@ require(\"commoner\").resolve(function(id) {\n \n }).process(function(id, source) {\n var context = this;\n+ var constants = context.config.constants || {};\n \n \/\/ This is where JSX, ES6, etc. desugaring happens.\n source = transform(visitors.react, source).code;\n \n- return context.makePromise(function(callback) {\n- var constants = context.config.constants || {};\n-\n- \/\/ Debranching means removing any obviously dead code after\n- \/\/ replacing constant conditional expressions with literal\n- \/\/ (boolean) values.\n- debranch(constants, source, function(source) {\n- callback(null, source);\n- });\n- });\n+ \/\/ Constant propagation means removing any obviously dead code after\n+ \/\/ replacing constant expressions with literal (boolean) values.\n+ return propagate(constants, source);\n });\ndiff --git a\/docs\/_includes\/nav_docs.html b\/docs\/_includes\/nav_docs.html\nindex d6d9e945a9..1dbd3b5c91 100644\n--- a\/docs\/_includes\/nav_docs.html\n+++ b\/docs\/_includes\/nav_docs.html\n@@ -21,4 +21,11 @@\n

Appendix<\/h3>\n+
\n+
JSX is not HTML<\/a><\/li>\n+ <\/ul>\n+ <\/div>\n <\/div>\ndiff --git a\/docs\/_layouts\/docs.html b\/docs\/_layouts\/docs.html\nindex 8df307908b..ff0b835ac3 100644\n--- a\/docs\/_layouts\/docs.html\n+++ b\/docs\/_layouts\/docs.html\n@@ -20,6 +20,6 @@ sectionid: docs\n {% endif %}\n <\/div>\n \n-
<\/div>\n+
<\/div>\n <\/div>\n <\/section>\ndiff --git a\/docs\/_layouts\/post.html b\/docs\/_layouts\/post.html\nindex 656085dcb6..9aa96b3565 100644\n--- a\/docs\/_layouts\/post.html\n+++ b\/docs\/_layouts\/post.html\n@@ -16,6 +16,6 @@ sectionid: blog\n <\/div>\n \n
<\/div>\n-
<\/div>\n+
<\/div>\n <\/div>\n <\/section>\ndiff --git a\/docs\/_posts\/2013-06-12-community-roundup.md b\/docs\/_posts\/2013-06-12-community-roundup.md\nindex f5e63a098b..d37e3b1351 100644\n--- a\/docs\/_posts\/2013-06-12-community-roundup.md\n+++ b\/docs\/_posts\/2013-06-12-community-roundup.md\n@@ -8,14 +8,14 @@ React was open sourced two weeks ago and it's time for a little round-up of what\n \n ## Khan Academy Question Editor\n \n-It looks like [Ben Alpert](http:\/\/benalpert.com\/) is the first person outside of Facebook and Instagram to push React code to production. We are very grateful for his contributions in form of pull requests, bug reports and presence on IRC ([#reactjs on Freenode](irc:\/\/chat.freenode.net\/reactjs)). Ben wrote about his experience using React on Quora:\n+It looks like [Ben Alpert](http:\/\/benalpert.com\/) is the first person outside of Facebook and Instagram to push React code to production. We are very grateful for his contributions in form of pull requests, bug reports and presence on IRC ([#reactjs on Freenode](irc:\/\/chat.freenode.net\/reactjs)). Ben wrote about his experience using React:\n \n > I just rewrote a 2000-line project in React and have now made a handful of pull requests to React. Everything about React I've seen so far seems really well thought-out and I'm proud to be the first non-FB\/IG production user of React.\n >\n > The project that I rewrote in React (and am continuing to improve) is the Khan Academy question editor which content creators can use to enter questions and hints that will be presented to students:\n->
[![](\/react\/img\/blog\/khan-academy-editor.png)](http:\/\/www.quora.com\/React-JS-Library\/How-is-Facebooks-React-JavaScript-library\/answer\/Ben-Alpert)<\/figure>\n+>
[![](\/react\/img\/blog\/khan-academy-editor.png)](http:\/\/benalpert.com\/2013\/06\/09\/using-react-to-speed-up-khan-academy.html)<\/figure>\n >\n-> [Read the full post...](http:\/\/www.quora.com\/React-JS-Library\/How-is-Facebooks-React-JavaScript-library\/answer\/Ben-Alpert)\n+> [Read the full post...](http:\/\/benalpert.com\/2013\/06\/09\/using-react-to-speed-up-khan-academy.html)\n \n ## Pimp my Backbone.View (by replacing it with React)\n \ndiff --git a\/docs\/_posts\/2013-06-19-community-roundup-2.md b\/docs\/_posts\/2013-06-19-community-roundup-2.md\nnew file mode 100644\nindex 0000000000..57b322e1cc\n--- \/dev\/null\n+++ b\/docs\/_posts\/2013-06-19-community-roundup-2.md\n@@ -0,0 +1,71 @@\n+---\n+title: \"Community Round-up #2\"\n+layout: post\n+author: Vjeux\n+---\n+\n+Since the launch we have received a lot of feedback and are actively working on React 0.4. In the meantime, here are the highlights of this week.\n+\n+## Some quick thoughts on React\n+\n+[Andrew Greig](http:\/\/www.andrewgreig.com\/) made a blog post that gives a high level description of what React is.\n+\n+> I have been using Facebooks recently released Javascript framework called React.js for the last few days and have managed to obtain a rather high level understanding of how it works and formed a good perspective on how it fits in to the entire javascript framework ecosystem.\n+>\n+> Basically, React is not an MVC framework. It is not a replacement for Backbone or Knockout or Angular, instead it is designed to work with existing frameworks and help extend their functionality.\n+>\n+> It is designed for building big UIs. The type where you have lots of reusable components that are handling events and presenting and changing some backend data. In a traditional MVC app, React fulfils the role of the View. So you would still need to handle the Model and Controller on your own.\n+>\n+> I found the best way to utilise React was to pair it with Backbone, with React replacing the Backbone View, or to write your own Model\/Data object and have React communicate with that.\n+>\n+> [Read the full post...](http:\/\/www.andrewgreig.com\/637\/)\n+\n+## React and Socket.IO Chat Application\n+\n+[Danial Khosravi](http:\/\/danialk.github.io\/) made a real-time chat application that interacts with the back-end using Socket.IO.\n+\n+> A week ago I was playing with AngularJS and [this little chat application](https:\/\/github.com\/btford\/angular-socket-io-im) which uses socket.io and nodejs for realtime communication. Yesterday I saw a post about ReactJS in [EchoJS](http:\/\/www.echojs.com\/) and started playing with this UI library. After playing a bit with React, I decided to write and chat application using React and I used Bran Ford's Backend for server side of this little app.\n+>
[![](\/react\/img\/blog\/chatapp.png)](http:\/\/danialk.github.io\/blog\/2013\/06\/16\/reactjs-and-socket-dot-io-chat-application\/)<\/figure>\n+>\n+> [Read the full post...](http:\/\/danialk.github.io\/blog\/2013\/06\/16\/reactjs-and-socket-dot-io-chat-application\/)\n+\n+## React and Other Frameworks\n+\n+[Pete Hunt](http:\/\/www.petehunt.net\/blog\/) wrote an answer on Quora comparing React and Angular directives. At the end, he explains how you can make an Angular directive that is in fact being rendered with React.\n+\n+> To set the record straight: React components are far more powerful than Angular templates; they should be compared with Angular's directives instead. So I took the first Google hit for \"AngularJS directive tutorial\" (AngularJS Directives Tutorial - Fundoo Solutions), rewrote it in React and compared them. [...]\n+>\n+> We've designed React from the beginning to work well with other libraries. Angular is no exception. Let's take the original Angular example and use React to implement the fundoo-rating directive.\n+>\n+> [Read the full post...](http:\/\/www.quora.com\/Pete-Hunt\/Posts\/Facebooks-React-vs-AngularJS-A-Closer-Look)\n+\n+In the same vein, [Markov Twain](https:\/\/twitter.com\/markov_twain\/status\/345702941845499906) re-implemented the examples on the front-page [with Ember](http:\/\/jsbin.com\/azihiw\/2\/edit) and [Vlad Yazhbin](https:\/\/twitter.com\/vla) re-implemented the tutorial [with Angular](http:\/\/jsfiddle.net\/vla\/Cdrse\/).\n+\n+## Web Components: React & x-tags\n+\n+Mozilla and Google are actively working on Web Components. [Vjeux](http:\/\/blog.vjeux.com\/) wrote a proof of concept that shows how to implement them using React.\n+\n+> Using [x-tags](http:\/\/www.x-tags.org\/) from Mozilla, we can write custom tags within the DOM. This is a great opportunity to be able to write reusable components without being tied to a particular library. I wrote [x-react](https:\/\/github.com\/vjeux\/react-xtags\/) to have them being rendered in React.\n+>
[![](\/react\/img\/blog\/xreact.png)](http:\/\/blog.vjeux.com\/2013\/javascript\/custom-components-react-x-tags.html)<\/figure>\n+>\n+> [Read the full post...](http:\/\/blog.vjeux.com\/2013\/javascript\/custom-components-react-x-tags.html)\n+\n+## React TodoMVC Example\n+\n+[TodoMVC.com](http:\/\/todomvc.com\/) is a website that collects various implementations of the same basic Todo app. [Pete Hunt](http:\/\/www.petehunt.net\/blog\/) wrote an idiomatic React version.\n+\n+> Developers these days are spoiled with choice when it comes to selecting an MV* framework for structuring and organizing their JavaScript web apps.\n+>\n+> To help solve this problem, we created TodoMVC - a project which offers the same Todo application implemented using MV* concepts in most of the popular JavaScript MV* frameworks of today.\n+>
[![](\/react\/img\/blog\/todomvc.png)](http:\/\/todomvc.com\/labs\/architecture-examples\/react\/)<\/figure>\n+>\n+> [Read the source code...](https:\/\/github.com\/tastejs\/todomvc\/tree\/gh-pages\/labs\/architecture-examples\/react)\n+\n+## JSX is not HTML\n+\n+Many of you pointed out differences between JSX and HTML. In order to clear up some confusion, we have added some documentation that covers the four main differences:\n+\n+ - [Whitespace removal](http:\/\/facebook.github.io\/react\/docs\/jsx-is-not-html.html)\n+ - [HTML Entities](http:\/\/facebook.github.io\/react\/docs\/jsx-is-not-html.html)\n+ - [Comments](http:\/\/facebook.github.io\/react\/docs\/jsx-is-not-html.html)\n+ - [Custom HTML Attributes](http:\/\/facebook.github.io\/react\/docs\/jsx-is-not-html.html)\ndiff --git a\/docs\/_posts\/2013-06-21-react-v0-3-3.md b\/docs\/_posts\/2013-06-21-react-v0-3-3.md\nnew file mode 100644\nindex 0000000000..668c83de1a\n--- \/dev\/null\n+++ b\/docs\/_posts\/2013-06-21-react-v0-3-3.md\n@@ -0,0 +1,24 @@\n+---\n+title: \"React v0.3.3\"\n+layout: post\n+author: Paul O'Shannessy\n+---\n+\n+We have a ton of great stuff coming in v0.4, but in the meantime we're releasing v0.3.3. This release addresses some small issues people were having and simplifies our tools to make them easier to use.\n+\n+\n+## react-tools\n+\n+* Upgrade Commoner so `require` statements are no longer relativized when passing through the transformer. This was a feature needed when building React, but doesn't translate well for other consumers of `bin\/jsx`.\n+* Upgraded our dependencies on Commoner and Recast so they use a different directory for their cache.\n+* Freeze our esprima dependency.\n+\n+\n+## React\n+\n+* Allow reusing the same DOM node to render different components. e.g. `React.renderComponent(, domNode); React.renderComponent(, domNode);` will work now.\n+\n+\n+## JSXTransformer\n+\n+* Improved the in-browser transformer so that transformed scripts will execute in the expected scope. The allows components to be defined and used from separate files.\ndiff --git a\/docs\/_posts\/2013-06-27-community-roundup-3.md b\/docs\/_posts\/2013-06-27-community-roundup-3.md\nnew file mode 100644\nindex 0000000000..50fed07978\n--- \/dev\/null\n+++ b\/docs\/_posts\/2013-06-27-community-roundup-3.md\n@@ -0,0 +1,91 @@\n+---\n+title: \"Community Round-up #3\"\n+layout: post\n+author: Vjeux\n+---\n+\n+The highlight of this week is that an interaction-heavy app has been ported to React. React components are solving issues they had with nested views.\n+\n+## Moving From Backbone To React\n+\n+[Clay Allsopp](http:\/\/twitter.com\/clayallsopp) successfuly ported [Propeller](http:\/\/usepropeller.com\/blog\/posts\/from-backbone-to-react\/), a fairly big, interaction-heavy JavaScript app, to React.\n+\n+> [](http:\/\/usepropeller.com\/blog\/posts\/from-backbone-to-react\/)Subviews involve a lot of easy-to-forget boilerplate that Backbone (by design) doesn't automate. Libraries like Backbone.Marionette offer more abstractions to make view nesting easier, but they're all limited by the fact that Backbone delegates how and went view-document attachment occurs to the application code.\n+>\n+> React, on the other hand, manages the DOM and only exposes real nodes at select points in its API. The \"elements\" you code in React are actually objects which wrap DOM nodes, not the actual objects which get inserted into the DOM. Internally, React converts those abstractions into actual DOMElements and fills out the document accordingly. [...]\n+>\n+> We moved about 20 different Backbone view classes to React over the past few weeks, including the live-preview pane that you see in our little iOS demo. Most importantly, it's allowed us to put energy into making each component work great on its own, instead of spending extra cycles to ensure they function in unison. For that reason, we think React is a more scalable way to build view-intensive apps than Backbone alone, and it doesn't require you to drop-everything-and-refactor like a move to Ember or Angular would demand.\n+>\n+> [Read the full post...](http:\/\/usepropeller.com\/blog\/posts\/from-backbone-to-react\/)\n+\n+## Grunt Task for JSX\n+\n+[Eric Clemmons](http:\/\/ericclemmons.github.io\/) wrote a task for [Grunt](http:\/\/gruntjs.com\/) that applies the JSX transformation to your Javascript files. It also works with [Browserify](http:\/\/browserify.org\/) if you want all your files to be concatenated and minified together.\n+\n+> Grunt task for compiling Facebook React's .jsx templates into .js\n+>\n+> ```javascript\n+grunt.initConfig({\n+ react: {\n+ app: {\n+ options: { extension: 'js' },\n+ files: { 'path\/to\/output\/dir': 'path\/to\/jsx\/templates\/dir' }\n+```\n+>\n+> It also works great with `grunt-browserify`!\n+>\n+> ```javascript\n+browserify: {\n+ options: {\n+ transform: [ require('grunt-react').browserify ]\n+ },\n+ app: {\n+ src: 'path\/to\/source\/main.js',\n+ dest: 'path\/to\/target\/output.js'\n+```\n+>\n+> [Check out the project ...](https:\/\/github.com\/ericclemmons\/grunt-react)\n+\n+## Backbone\/Handlebars Nested Views\n+\n+[Joel Burget](http:\/\/joelburget.com\/) wrote a blog post talking about the way we would write React-like components in Backbone and Handlebars.\n+\n+> The problem here is that we're trying to maniplate a tree, but there's a textual layer we have to go through. Our views are represented as a tree - the subviews are children of CommentCollectionView - and they end up as part of a tree in the DOM. But there's a Handlebars layer in the middle (which deals in flat strings), so the hierarchy must be destructed and rebuilt when we render.\n+>\n+> What does it take to render a collection view? In the Backbone\/Handlebars view of the world you have to render the template (with stubs), render each subview which replaces a stub, and keep a reference to each subview (or anything within the view that could change in the future).\n+>\n+> So while our view is conceptually hierarchical, due to the fact that it has to go through a flat textual representation, we need to do a lot of extra work to reassemble that structure after rendering.\n+>\n+> [Read the full post...](http:\/\/joelburget.com\/react\/)\n+\n+## JSRomandie Meetup\n+\n+[Renault John Lecoultre](https:\/\/twitter.com\/renajohn\/) from [BugBuster](http:\/\/www.bugbuster.com) did a React introduction talk at a JS meetup called [JS Romandie](https:\/\/twitter.com\/jsromandie) last week.\n+\n+

dillon1000/react

Files changed