Final release, deprecation, codemod stuff

Author: jsdf

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## [5.0.0]
+- final release / deprecation
+- added opts for codemod use
+
 ## [4.0.0]
 - Replace `React.__spread` with `Object.assign` ([DawidJanczak](https://github.com/DawidJanczak))
 - Allow spaces in spread attributes ([rechtar](https://github.com/rechtar))

README.md

@@ -1,10 +1,25 @@
 # Coffeescript React JSX Transformer
 
-Provides support for an equivalent of JSX syntax in Coffeescript (called CJSX) so you can write your Facebook React components with the full awesomeness of Coffeescript. [Try it out](https://jsdf.github.io/coffee-react-transform/).
+# STATUS: DEPRECATED
 
-#### Status
+This tool is no longer maintained. If you need to transition your codebase from
+it, a codemod is available to do so: [cjsx-codemod](https://github.com/jsdf/cjsx-codemod)
 
-This project is seeking maintainers. If you are interested in becoming a maintainer [create an issue](https://github.com/jsdf/coffee-react-transform/issues). Pull requests will be reviewed and merged (time permitting), but this project is not currently under active development.
+This project started as a way for me to explore how JSX could fit into
+Coffeescript syntax, as a quickly hacked together prototype. While I never
+really promoted it, it quickly took on a life of its own, and before long people
+were asking for it to support all kinds of different use cases. On top of that I
+had no experience writing parsers, so the result is something with 
+[insurmountable limitations](https://github.com/jsdf/coffee-react/issues/32).
+
+As I eventually stopped using Coffeescript I ended up neglecting this project,
+but as people were using it I didn't want to kill it. I really should have,
+however, because it meant that people were using a crappy, ill-conceived,
+unmaintained tool. Now, long overdue, I'm putting it out to pasture.
+
+Original readme follows:
+
+Provides support for an equivalent of JSX syntax in Coffeescript (called CJSX) so you can write your React components with the full awesomeness of Coffeescript. [Try it out](https://jsdf.github.io/coffee-react-transform/).
 
 #### Example
 

package.json

@@ -9,7 +9,7 @@
     "coffee-react"
   ],
   "author": "James Friend",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "licenses": [
     {
       "type": "MIT",

src/serialiser.coffee

@@ -7,11 +7,26 @@ stringEscape = require './stringescape'
 
 entityDecode = require './entitydecode'
 
-module.exports = exports = serialise = (parseTree) ->
-  new Serialiser().serialise(parseTree)
+module.exports = exports = serialise = (parseTree, opts) ->
+  new Serialiser().serialise(parseTree, opts)
+
+DEFAULT_CREL_EXPR = '`${REACT}.createElement(${ELEMENT}, ${ARGS})`'
+
+makeCreateElementTemplate = (pattern) ->
+  eval """
+    function template(REACT, ELEMENT, ARGS) {
+      return #{pattern};
+    }
+  """
+  template
 
 class Serialiser
-  serialise: (parseTree) ->
+  serialise: (parseTree, @opts = {}) ->
+    @hasJSX = false
+    @jsxExpression = makeCreateElementTemplate(
+      @opts.jsxExpression || DEFAULT_CREL_EXPR
+    )
+
     if parseTree.children and
     parseTree.children.length and
     parseTree.children[0].type is $.CJSX_PRAGMA
@@ -25,7 +40,13 @@ class Serialiser
     else
       @reactObject = 'React'
 
-    @serialiseNode(parseTree)
+    serialised = @serialiseNode(parseTree)
+
+    # hack to add extra stuff at the top if JSX was used
+    if @opts.jsxImport and @hasJSX
+      "#{@opts.jsxImport}\n#{serialised}"
+    else
+      serialised
 
   serialiseNode: (node) ->
     unless nodeSerialisers[node.type]?
@@ -183,7 +204,9 @@ nodeSerialisers =
       element = node.value
     else
       element = '"'+node.value+'"'
-    "#{@reactObject}.createElement(#{element}, #{joinList(serialisedChildren)})"
+
+    @hasJSX = true # hack
+    @jsxExpression(@reactObject, element, joinList(serialisedChildren))
 
   CJSX_COMMENT: (node) ->
     ''

src/transformer.coffee

@@ -3,4 +3,4 @@ Parser = require './parser'
 serialise = require './serialiser'
 
 module.exports.transform = (code, opts) ->
-  serialise(new Parser().parse(code, opts))
+  serialise(new Parser().parse(code, opts), opts)