@danielx/civet 0.4.14 → 0.4.16

package/README.md

@@ -41,10 +41,10 @@ fileCache : Record<string, any> := {}
 
 createCompilerHost := (options: CompilerOptions, moduleSearchLocations : string[]) ->
   fileExists := (fileName: string) : boolean ->
-    return fileCache[fileName]?
+    fileCache[fileName]?
 
   readFile := (fileName: string) ->
-    return fileCache[fileName]
+    fileCache[fileName]
 ```
 
 ESBuild Plugin
@@ -98,6 +98,8 @@ Things Kept from CoffeeScript
 - `when` inside `switch` automatically breaks
 - 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]`
 - Implicit returns
 - Simplified number method calls `1.toFixed()` -> `1..toFixed()`
 - JSX 😿
@@ -105,7 +107,7 @@ Things Kept from CoffeeScript
 Things Removed from CoffeeScript
 ---
 
-- `on/yes/off/no` (use `true/false`, `"civet coffeeCompat"`)
+- `on/yes/off/no` (use `true/false`, or `"civet coffeeCompat"` to add them back)
 - `isnt` (use `!==`)
 - `not` (use `!`)
 - `do` keyword (replaced with JS `do`, invoke using existing `(-> ...)()` syntax)
@@ -115,16 +117,17 @@ Things Removed from CoffeeScript
 - 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 declarations (in compat mode only)
+  - Implicit `var` declarations (in compat mode only)
 - Might add later
+  - Braceless inline objects `x = coolStory: true`
   - Comprensions
-  - Array slices `list[0...2]` (use `list.slice(0, 2)`)
   - `///` Heregexp
-  - Slice assignment `numbers[3..6] = [-3, -4, -5, -6]` (use `numbers.splice(3, 4, -3, -4, -5, -6)`)
   - Ranges `[0...10]`
   - Rest parameter in any assignment position
+  - Multiple slice assignment `otherNumbers[0...] = numbers[3..6] = [-3, -4, -5, -6]`
 
 Things Changed from CoffeeScript
 ---
@@ -141,6 +144,8 @@ Things Changed from CoffeeScript
 - 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)
+`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
@@ -211,7 +216,8 @@ Things Changed from ES6
 - `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.
-- When exponent follows a dot it is treated as a property access since we simplified `1.toString()` -> `1..toString()` and an exponent
+- 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`