@danielx/civet 0.2.11 → 0.2.14

package/README.md

@@ -46,6 +46,25 @@ createCompilerHost := (options: CompilerOptions, moduleSearchLocations : string[
     return 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
 ---
 
@@ -54,6 +73,7 @@ Things Kept from CoffeeScript
 - `and` -> `&&`
 - `loop` -> `while(true)`
 - `unless` conditional (without the `else`)
+- `until condition` -> `while(!condition)`
 - Object literal syntax
   ```coffee
   x =
@@ -66,15 +86,13 @@ Things Kept from CoffeeScript
 - Optional semi-colons
 - Indentation based block syntax
 - OptionalChain shorthand for index and function application `a?[b]` -> `a?.[b]`, `a?(b)` -> `a?.(b)`
-- `@` -> `this`
-- `@id` -> `this.id`
+- `@` This shorthand `@` -> `this`, `@id` -> `this.id`
+- Prototype shorthand `X::` -> `X.prototype`, `X::a` -> `X.prototype.a`
 - Postfix `if/unless`
 - JSX 😿
 - TODO
   - [ ] `"""` Strings (for compatibility with existing .coffee code)
   - [ ] Chained comparisons
-  - [ ] `until`
-  - [ ] Prototype shorthand `X::` -> `X.prototype`, `X::a` -> `X.prototype.a`
 
 Things Removed from CoffeeScript
 ---
@@ -122,8 +140,7 @@ Things Added that CoffeeScript didn't
   - OptionalChain longhand
   - ConditionalExpression
   - `case` statement
-  - `while`
-  - `do`
+  - `do`, `do { ... } until condition`
 - Const assignment shorthand `a := b` -> `const a = b`; `{a, b} := c` -> `const {a, b} = c`
 - Convenience for ES6+ Features
   - `<` as `extends` shorthand
@@ -131,7 +148,7 @@ Things Added that CoffeeScript didn't
 - ClassStaticBlock
 - `get`/`set` method definitions
 - Private identifiers `#id`
-- Shebang line
+- Shebang line is kept unmodified in output
   ```civet
   #!./node_modules/.bin/ts-node
   console.log "hi"
@@ -141,6 +158,6 @@ Things Changed from ES6
 ---
 
 - Disallow no parens on single argument arrow function. `x => ...` must become `(x) => ...`
-  The reasoning is `x -> ` => `x(function() ...)` in CoffeeScript and having `->` and `=>`
+  The reasoning is `x -> ...` => `x(function() ...)` in CoffeeScript and having `->` and `=>`
   behave more differently than they already do is bad. Passing an anonymous function to an
   application without parens is also convenient.