@danielx/civet 0.4.33 → 0.4.35

package/README.md

@@ -97,7 +97,7 @@ Things Kept from CoffeeScript
 - RestElement/RestParameter in any position `(first, ...midle, last) ->` -> `function(first, ...middle) { let [last] = middle.splice(-1)}`
 - `///` Heregexp
   - With some [changes](#things-changed-from-coffeescript).
-- JSX 😿
+- JSX
 
 Things Removed from CoffeeScript
 ---
@@ -142,17 +142,7 @@ Things Changed from CoffeeScript
 - Postfix iteration/conditionals always wrap the statement [#5431](https://github.com/jashkenas/coffeescript/issues/5431)
 `try x() if y` -> `if (y) try x()`
 - Civet tries to keep the transpiled output verbatim as much as possible.
-  In Coffee `(x)` -> `x;` but in Civet `(x)` -> `(x);`.
-  Also in Coffee
-  ```coffee
-    x    +    3
-  ```
-  -> `x + 3` without the spacing
-  In Civet
-  ```typescript
-    x    +    3
-  ```
-  remains as is.
+  In Coffee `(x)` -> `x;` but in Civet `(x)` -> `(x)`. Spacing and comments are also preserved as much as possible.
 - Heregex / re.X
   - Stay closer to the [Python spec](https://docs.python.org/3/library/re.html#re.X)
   - Allows both kinds of substitutions `#{..}`, `${..}`.
@@ -181,8 +171,8 @@ Things Added that CoffeeScript didn't
     ```
     ```typescript
       class A {
-        readonly x = 3;
-      };
+        readonly x = 3
+      }
     ```
 - JS Compatability
   - `var`, `let`, `const`
@@ -196,7 +186,7 @@ Things Added that CoffeeScript didn't
   - `get`/`set` method definitions
   - Private identifiers `#id`
 - Convenience for ES6+ Features
-  - Const assignment shorthand `a := b` -> `const a = b`; `{a, b} := c` -> `const {a, b} = c`
+  - Const assignment shorthand `a := b` -> `const a = b`, `{a, b} := c` -> `const {a, b} = c`
   - `@#id` -> `this.#id` shorthand for private identifiers
   - `import` shorthand: `x from ./x` -> `import x from "./x"`
   - `export` shorthand: `export x, y` -> `export {x, y}`
@@ -211,8 +201,17 @@ Things Added that CoffeeScript didn't
   - unary operators `x.map !!&`, -> `x.map($ => !!$)`
   - binary operators `x.map &+1` -> `x.map($ => $+1)`
 - Flagging shorthand [from LiveScript](https://livescript.net/#literals) `{+debug, -live}` -> `{debug: true, live: false}`
-- Indentation JSX: instead of explicitly closing `<tag>`s or `<>`s,
-  you can indent the children and Civet will close your tags for you
+- JSX enhancements:
+  - Indentation: instead of explicitly closing `<tag>`s or `<>`s,
+    you can indent the children and Civet will close your tags for you
+  - Any braced object literal can be used as an attribute.
+    `{foo}` -> `foo={foo}`, `{foo: bar}` -> `foo={bar}`,
+    `{...foo}` remains as is; methods and getters/setters work too.
+  - Many attribute values (basic literals, array literals, braced object
+    literals, regular expressions, template strings, and parenthesized
+    expressions) do not need braces.  `foo=bar` -> `foo={bar}`
+  - Attributes can use computed property names:
+    `[expr]={value}` -> `{...{[expr]: value}}`
 - CoffeeScript improvements
   - Postfix loop `run() loop` -> `while(true) run()`
   - Character range literals `["a".."z"]`, `['f'..'a']`, `['0'..'9']`