@danielx/civet 0.4.16 → 0.4.17

package/README.md

@@ -99,28 +99,32 @@ Things Kept from CoffeeScript
 - Multiple `,` separated `case`/`when` expressions
 - `else` -> `default` in `switch`
 - Array slices `list[0...2]` -> `list.slice(0, 2)`
-- Slice assignment `numbers[3..6] = [-3, -4, -5, -6]`
+- Slice assignment `numbers[3..6] = [-3, -4, -5, -6]` -> `numbers.splice(3, 4, ...[-3, -4, -5, -6])`
 - Implicit returns
 - Simplified number method calls `1.toFixed()` -> `1..toFixed()`
+- `if`/`switch` expressions
+- Destructuring object assignment doesn't require being wrapped in parens at the statement level `{a, b} = c` -> `({a, b} = c)`
 - JSX 😿
 
 Things Removed from CoffeeScript
 ---
 
-- `on/yes/off/no` (use `true/false`, or `"civet coffeeCompat"` to add them back)
-- `isnt` (use `!==`)
-- `not` (use `!`)
+- Implicit `var` declarations (use `civet coffeeCompat` or `"civet autoVar"`)
+- `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 in`
+  - `not of`
 - `do` keyword (replaced with JS `do`, invoke using existing `(-> ...)()` syntax)
 - `for from` (use JS `for of`)
+- `for own of` (use JS `for in` and check manually, switch to `Map#keys/values/entries`, or use `Object.create(null)`)
 - `and=`, `or=` (don't mix and match words and symbols)
 - `a ? b` (use `a ?? b`, though it doesn't check for undeclared variables)
 - Iteration expression results
 - Backtick embedded JS (replaced by template literals)
 - Will likely add later
   - Optional assignment `x?.y = 3` -> `x != null ? x.y = 3 : undefined`
-  - `switch` expressions
-  - `if` expressions
-  - Implicit `var` declarations (in compat mode only)
 - Might add later
   - Braceless inline objects `x = coolStory: true`
   - Comprensions
@@ -141,7 +145,6 @@ Things Changed from CoffeeScript
 - `x?()` -> `x?.()` instead of `if (typeof x === 'function') { x() }`
 - Backtick embedded JS has been replaced with JS template literals.
 - No longer allowing multiple postfix `if/unless` on the same line (use `&&` or `and` to combine conditions).
-- No `else` block on `unless` (negate condition and use `if`)
 - `#{}` interpolation in `""` strings only when `"civet coffeeCompat"` or `"civet coffeeInterpolation"`
 - Expanded chained comparisons to work on more operators `a in b instanceof C` -> `a in b && b instanceof C`
 - Postfix iteration/conditionals always wrap the statement [#5431](https://github.com/jashkenas/coffeescript/issues/5431)
@@ -192,12 +195,12 @@ Things Added that CoffeeScript didn't
   - Private identifiers `#id`
 - Convenience for ES6+ Features
   - Const assignment shorthand `a := b` -> `const a = b`; `{a, b} := c` -> `const {a, b} = c`
-  - `<` as `extends` shorthand
   - `@#id` -> `this.#id` shorthand for private identifiers
   - `import` shorthand `x from ./x` -> `import x from "./x"`
-  - `\`\`\`` Block Template Strings remove leading indentation for clarity
+  - Triple backtick Template Strings remove leading indentation for clarity
   - Class constructor shorthand `@( ... )`
   - ClassStaticBlock `@ { ... }`
+  - `<` as `extends` shorthand
 - Postfix loop `run() loop` -> `while(true) run()`
 - Shebang line is kept unmodified in output
   ```civet
@@ -214,12 +217,13 @@ Things Changed from ES6
   behave more differently than they already do is bad. Passing an anonymous function to an
   application without parens is also convenient.
 - `for(i of x) ...` defaults to const declaration -> `for(const i of x) ...`
-- Disallow comma operator in conditionals. `if x, y`
-- Comma operator in case/when becomes multiple conditions.
+- Disallow comma operator in conditionals and many other places. `if x, y` is not allowed.
+- Comma operator in `case`/`when` instead becomes multiple conditions.
 - Numbers can't end with a dot (otherwise would be ambiguous with CoffeeScript slices `y[0..x]`). This also implies that you can't access properties
 of numbers with `1..toString()` use `1.toString()` instead. When exponent follows a dot it is treated as a property access since an exponent
 could be a valid property `1.e10` -> `1..e10`. The workaround is to add a trailing zero `1.0e10` or remove the dot before the exponent `1e10`.
 - Additional reserved words `and`, `or`, `loop`, `until`, `unless`
+- No whitespace between unary operators and operands. Mandatory whitespace between condition and ternary `?` ex. `x ? a : b` since `x?` is the unary existential operator.
 
 CoffeeScript Compatibility
 ---
@@ -231,6 +235,7 @@ coffeeBooleans (yes/no/on/off)
 coffeeComment  (# single line comments)
 coffeeEq       (`==` -> `===`, `!=` -> `!==`)
 coffeeInterpolation (`"a string with {myVar}"`)
+coffeeIsnt     (`isnt` -> `!==`)
 ```
 
 You can use these with `"civet coffeeCompat"` to opt in to all or use them bit by bit with `"civet coffeeComment coffeeEq coffeeInterpolation"`.