From 2591a4beb7fea304beed96102d159d9286db5c83 Mon Sep 17 00:00:00 2001
From: Ingvar Stepanyan <me@rreverser.com>
Date: Wed, 3 Sep 2014 13:55:36 +0300
Subject: [PATCH 1/2] Added Parser AST format specification.

---
 AST.md | 126 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 AST.md

diff --git a/AST.md b/AST.md
new file mode 100644
index 0000000..d03d46d
--- /dev/null
+++ b/AST.md
@@ -0,0 +1,126 @@
+JSX extensions to Mozilla AST Format
+====================================
+
+JSX extends ECMAScript [Mozilla AST format](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey/Parser_API) with following node types:
+
+JSX Names
+---------
+
+__JSX Identifier subtype__
+
+```
+interface XJSIdentifier <: Identifier {
+    type: "XJSIdentifier";
+}
+```
+
+__Namespaced names__
+
+Property-like namespace syntax (tag names only):
+
+```
+interface XJSMemberExpression <: Expression, Pattern {
+    type: "XJSMemberExpression";
+    object: XJSMemberExpression | XJSIdentifier,
+    property: XJSIdentifier
+}
+```
+
+XML-based namespace syntax:
+
+```
+interface XJSNamespacedName <: Expression, Pattern {
+    type: "XJSNamespacedName";
+    namespace: XJSIdentifier,
+    name: XJSIdentifier
+}
+```
+
+JSX Expression Container
+------------------------
+
+JSX adds empty "expression" type in order to allow comments in JSX text:
+
+```
+interface XJSEmptyExpression <: Node {
+    type: "XJSEmptyExpression"
+}
+```
+
+Any expression used as attribute value or inside JSX text should is wrapped into expression container:
+
+```
+interface XJSExpressionContainer <: Node {
+    type: "XJSExpressionContainer",
+    expression: Expression | XJSEmptyExpression;
+}
+```
+
+JSX Boundary Tags
+-----------------
+
+Any JSX element is bounded by tags &mdash; either self-closing or both opening and closing elements:
+
+```
+interface XJSBoundaryElement <: Node {
+    name: XJSIdentifier | XJSMemberExpression | XJSNamespacedName;
+}
+
+interface XJSOpeningElement <: XJSBoundaryElement {
+    type: "XJSOpeningElement",
+    attributes: [ XJSAttribute | XJSSpreadAttribute ],
+    selfClosing: boolean;
+}
+
+interface XJSClosingElement <: XJSBoundaryElement {
+    type: "XJSClosingElement"
+}
+```
+
+JSX Attributes
+--------------
+
+Opening element ("tag") may contain attributes:
+
+```
+interface XJSAttribute <: Node {
+    type: "XJSAttribute",
+    name: XJSIdentifier | XJSNamespacedName,
+    value: Literal | XJSExpressionContainer | XJSElement | null
+}
+
+// This is already used by ES6 parsers, but not included
+// in Mozilla's spec yet.
+interface SpreadElement <: Pattern {
+    type: "SpreadElement";
+    argument: Expression;
+}
+
+interface XJSSpreadAttribute <: SpreadElement {
+    type: "XJSSpreadAttribute";
+}
+```
+
+JSX Element
+-----------
+
+Finally, JSX element itself consists of opening element, list of children and optional closing element:
+
+```
+interface XJSElement <: Expression {
+    type: "XJSElement",
+    openingElement: XJSOpeningElement,
+    children: [ Literal | XJSExpressionContainer | XJSElement ],
+    closingElement: XJSClosingElement | null
+}
+```
+
+Tools that work with JSX AST
+----------------------------
+
+* Parsers:
+  - [acorn-jsx](https://github.com/RReverser/acorn-jsx): A fork of acorn.
+  - [esprima-fb](https://github.com/facebook/esprima): A fork of esprima.
+* Traversal: [estraverse-fb](https://github.com/RReverser/estraverse-fb).
+* Node creation and declarative traversal: [ast-types](https://github.com/benjamn/ast-types)
+* Transpiling to ECMAScript AST: [jsx-transpiler](https://github.com/RReverser/jsx-transpiler)

From 10fa858857b8da180018e0bab157ef4febd4219b Mon Sep 17 00:00:00 2001
From: Ingvar Stepanyan <me@rreverser.com>
Date: Fri, 5 Sep 2014 21:11:26 +0300
Subject: [PATCH 2/2] Added license.

---
 AST.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/AST.md b/AST.md
index d03d46d..0a9fc93 100644
--- a/AST.md
+++ b/AST.md
@@ -124,3 +124,12 @@ Tools that work with JSX AST
 * Traversal: [estraverse-fb](https://github.com/RReverser/estraverse-fb).
 * Node creation and declarative traversal: [ast-types](https://github.com/benjamn/ast-types)
 * Transpiling to ECMAScript AST: [jsx-transpiler](https://github.com/RReverser/jsx-transpiler)
+
+License
+-------
+
+Copyright (c) 2014, Facebook, Inc.
+All rights reserved.
+
+This work is licensed under a [Creative Commons Attribution 4.0
+International License](http://creativecommons.org/licenses/by/4.0/).