@danielx/civet 0.4.17 → 0.4.19-pre.0

package/README.md

@@ -47,25 +47,6 @@ createCompilerHost := (options: CompilerOptions, moduleSearchLocations : string[
     fileCache[fileName]
 ```
 
-ESBuild Plugin
----
-
-```coffee
-esbuild = require "esbuild"
-civetPlugin = require "@danielx/civet/esbuild-plugin"
-
-esbuild.build
-  entryPoints: ['source/main.civet']
-  bundle: true
-  platform: 'node'
-  outfile: 'dist/main.js'
-  plugins: [
-    civetPlugin
-  ]
-.catch -> process.exit 1
-
-```
-
 Things Kept from CoffeeScript
 ---
 
@@ -73,7 +54,7 @@ Things Kept from CoffeeScript
 - `or` -> `||`
 - `and` -> `&&`
 - `loop` -> `while(true)`
-- `unless` conditional (without the `else`)
+- `unless exp` -> `if(!exp)`
 - `until condition` -> `while(!condition)`
 - Object literal syntax
   ```coffee
@@ -116,18 +97,22 @@ Things Removed from CoffeeScript
   - `not instanceof` (use `!(a instanceof b)`)
   - `not in`
   - `not of`
+  - 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)
-- `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)`)
+- `for from` (use JS `for of`, `"civet coffeeCompat"`, or `"civet coffeeForLoops"`)
+- `for own of` (use JS `for in` and check manually, switch to `Map#keys/values/entries`, or use `Object.create(null)`, or `"civet coffeeCompat"`, or `"civet coffeeForLoops"`)
+- `for ... when <condition>` (use `continue if exp` inside loop, `"civet coffeeCompat"`, or `"civet coffeeForLoops"`)
 - `and=`, `or=` (don't mix and match words and symbols)
 - `a ? b` (use `a ?? b`, though it doesn't check for undeclared variables)
+- `a of b` (use `a in b` matching JS, or `"civet coffeeCompat"`, or `"civet coffeeOf"`)
 - 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`
+  - Loop expressions (at least in compatibility mode)
+  - Conditional assignment `a?[x] = 3` -> `a ? a[x] = 3 : undefined`
 - Might add later
   - Braceless inline objects `x = coolStory: true`
-  - Comprensions
   - `///` Heregexp
   - Ranges `[0...10]`
   - Rest parameter in any assignment position
@@ -140,6 +125,7 @@ Things Changed from CoffeeScript
 - `!=` -> `!=` rather than `!==` (can be kept with `"civet coffeeCompat"`)
 - `for in` and `for of` are no longer swapped and become their JS equivalents.
 - `a...` is now `...a` just like JS
+- `a in b` is now `a in b` rather than `b.indexOf(a) >= 0`
 - `x?.y` now compiles to `x?.y` rather than the `if typeof x !== 'undefined' && x !== null` if check
 - Existential `x?` -> `(x != null)` no longer checks for undeclared variables.
 - `x?()` -> `x?.()` instead of `if (typeof x === 'function') { x() }`
@@ -201,6 +187,12 @@ Things Added that CoffeeScript didn't
   - Class constructor shorthand `@( ... )`
   - ClassStaticBlock `@ { ... }`
   - `<` as `extends` shorthand
+- Short function block syntax like [Ruby symbol to proc](https://ruby-doc.org/core-3.1.2/Symbol.html#method-i-to_proc), [Crystal](https://crystal-lang.org/reference/1.6/syntax_and_semantics/blocks_and_procs.html#short-one-parameter-syntax), [Elm record access](https://elm-lang.org/docs/records#access)
+  - access `x.map &.name` -> `x.map(a => a.name)`
+  - nested access + slices `x.map &.profile?.name[0...3]` -> `x.map(a => a.profile?.name.slice(0, 3))`
+  - function call `x.map &.callback a, b` -> `x.map($ => $.callback(a, b))`
+  - unary operators `x.map !!&`, -> `x.map($ => !!$)`
+  - binary operators `x.map &+1` -> `x.map($ => $+1)`
 - Postfix loop `run() loop` -> `while(true) run()`
 - Shebang line is kept unmodified in output
   ```civet
@@ -224,6 +216,7 @@ of numbers with `1..toString()` use `1.toString()` instead. When exponent follow
 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.
+- No labels (yet...)
 
 CoffeeScript Compatibility
 ---