@danielx/civet 0.4.20 → 0.4.22

package/README.md

@@ -90,7 +90,9 @@ Things Kept from CoffeeScript
 - Simplified number method calls `1.toFixed()` -> `1..toFixed()`
 - `if`/`switch`/`for`/`loop`/`while`/`throw` expressions
 - Destructuring object assignment doesn't require being wrapped in parens at the statement level `{a, b} = c` -> `({a, b} = c)`
-- Prefix or postfix splats `[...a]`, `x = [a...]`
+- Prefix or postfix rest/splats `[...a]`, `x = [a...]`
+- RestProperty in any position `{a, ...b, c} = d` -> `{a, c, ...b} = d`
+- 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 😿
@@ -106,8 +108,8 @@ Civet.
 - `on/yes/off/no` (use `true/false`, `"civet coffeeCompat"`, or `"civet coffeeBooleans"` to add them back)
 - `isnt` (use `!==`, `"civet coffeeCompat"`, or `"civet coffeeIsnt"`)
 - `not` (use `!`, `"civet coffeeCompat"`, or `"civet coffeeNot"`)
-  - `not instanceof` (use `!(a instanceof b)`)
-  - `not of`
+  - `not instanceof` (use `!(a instanceof b)`, `"civet coffeeCompat"`, or `"civet coffeeNot"`)
+  - `not of` use (`"civet coffeeCompat"`, or `"civet coffeeNot"`)
   - NOTE: CoffeeScript `not` precedence is dubious. `not a < b` should be equivalent to `!(a < b)` but it is in fact `!a < b`
 - `do` keyword (replaced with JS `do`, invoke using existing `(-> ...)()` syntax, `"civet coffeeCompat"`, or `"civet coffeeDo"`)
 - `for from` (use JS `for of`, `"civet coffeeCompat"`, or `"civet coffeeForLoops"`)
@@ -196,7 +198,8 @@ Things Added that CoffeeScript didn't
 - Convenience for ES6+ Features
   - 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"`
+  - `import` shorthand: `x from ./x` -> `import x from "./x"`
+  - `export` shorthand: `export x, y` -> `export {x, y}`
   - Triple backtick Template Strings remove leading indentation for clarity
   - Class constructor shorthand `@( ... )`
   - ClassStaticBlock `@ { ... }`
@@ -239,18 +242,19 @@ CoffeeScript Compatibility
 
 Civet provides a compatability prologue directive that aims to be 97+% compatible with existing CoffeeScript2 code (still a work in progress).
 
-```
-autoVar        (declare implicit vars based on assignment to undeclared identifiers)
-coffeeBooleans (yes/no/on/off)
-coffeeComment  (# single line comments)
-coffeeDo       ( `do ->`, disables ES6 do/while)
-coffeeEq       (`==` -> `===`, `!=` -> `!==`)
-coffeeForLoops (for in, of, from loops behave like they do in CoffeeScript)
-coffeeInterpolation (`"a string with #{myVar}"`)
-coffeeIsnt     (`isnt` -> `!==`)
-coffeeNot      (`not` -> "!") (currently doesn't support `not instanceof`, `not of`)
-coffeeOf       (`a of b` -> `a in b`, `a in b` -> `b.indexOf(a) >= 0`, `a not in b` -> `b.indexOf(a) < 0`)
-```
+| Configuration       | What it enables |
+|---------------------|---------------------------------------------------------------------|
+| autoVar             | declare implicit vars based on assignment to undeclared identifiers |
+| coffeeBooleans      | `yes`, `no`, `on`, `off` |
+| coffeeComment       | `# single line comments` |
+| coffeeDo            | `do ->`, disables ES6 do/while |
+| coffeeEq            | `==` -> `===`, `!=` -> `!==` |
+| coffeeForLoops      | for in, of, from loops behave like they do in CoffeeScript |
+| coffeeInterpolation | `"a string with #{myVar}"` |
+| coffeeIsnt          | `isnt` -> `!==` |
+| coffeeNot           | `not` -> `!`, `a not instanceof b` -> `!(a instanceof b)`, `a not of b` -> `!(a in b)`    |
+| coffeeOf            | `a of b` -> `a in b`, `a in b` -> `b.indexOf(a) >= 0`, `a not in b` -> `b.indexOf(a) < 0` |
+
 
 You can use these with `"civet coffeeCompat"` to opt in to all or use them bit by bit with `"civet coffeeComment coffeeEq coffeeInterpolation"`.
 Another possibility is to slowly remove them to provide a way to migrate files a little at a time `"civet coffeeCompat -coffeeBooleans -coffeeComment -coffeeEq"`.