Changed

• No longer allow keywords as index fields (generated invalid Lua code)
• Loaded compiled Lua chunks now have their source names embedded in their chunkname
  • #27
• Operator assignments no longer cause unnecessary duplicate indexing
  • #29
  • ex) my_expensive_function().x += 1 will now only call my_expensive_function once.
  • ex) a.b.c += 1 will only cause a to be indexed once.
• Erde now transforms variable names based on the scope they were declared with.
  • The most recently declared scope will always take precedence
  • ex) local x = 0; global x = 1; assert(x == 1)
• Erde now throws a parsing error when declaring a destructured variable with no value (ex. local { a };)
• Erde now throws a parsing error when using goto with an undefined label (same behavior as Lua)

Fixed

• Fixed allowing keywords as variable names
• Fixed compilation error for interpolation strings with only an escaped brace
  • #24
• Fixed return list failing to parse surround chars in strings
  • #21
• Fixed not being able to assign to the index of a function call result
  • #26
• Fixed parsing table string entry with only =
  • #28
• Fixed compilation of function declarations with Lua keywords
  • #25
• Fixed operator precedence fighting in operator assignments
  • #20
• Fixed erde compile failing when parent directories are not present
  • parent directories are now created recursively as needed
• Fixed mismatched names for Lua keywords when accessing _G or _MODULE
  • #18
• Fixed module declarations not updating _MODULE
  • #22
• Fixed continue generating invalid code when targeting 5.1(+)
  • #34
• Fixed return lists incorrectly interpreting expression commas as list commas
  • For example, returning an iife with a comma in the function body
• Fixed mangled stacktrace for bit library tail calls
  • https://www.freelists.org/post/luajit/Bad-stack-trace-from-lua-getstack-and-lua-getinfo,1

Added

• Erde will now throw a compiler error when targeting 5.1, 5.1+, or jit, and there are additional statements following a break.
  • Lua 5.1 / LuaJIT do not support statements following break (parsing error, similar to return)
  • #34
• Compiled files now include the Lua target at the bottom of the compiled file.
• Added specific error checks for common mistakes
  • ~= vs !=
  • elseif vs else if
• The Erde version is available via the API using erde.version

Changed

• BREAKING CHANGE: Functions no longer default to local
  • Differs too much from vanilla Lua
  • Unexpected behavior, especially for newer users
  • More confusing than helpful
• Allow excluding target from load (i.e. allow options table as only argument)
• When using the module keyword, users can now access the module table via _MODULE.
  • _MODULE is declared at the top of the module (accessible anywhere)
  • module declarations are immediately added to the _MODULE table

Fixed

• Fixed throwing object when failing to load compiled code
• Fixed erde loaders not handling multiple returns (package loader && erde.run)
• Fixed incorrect source map when code starts with newlines
• Fixed incorrect source map for function call statements
• erde.traceback now properly handles non-string messages
  • message is returned immediately without further processing
  • same behavior as Lua's native debug.traceback
• The bitwise unary ~ operator now properly uses native Lua for 5.3+ (previously always used bitlib)
• Erde now properly reports error lines as compiled error lines when there is no sourcemap
• Erde now properly injects the compile footer for empty files
• Fixed not throwing error when using both return and module
• Fixed erde (REPL) and erde run not respecting --target (#11)
• Fixed global destructuring (#14)
• Global declarations now directly mutate _G (#15)
• Fixed compilation of Lua (but not Erde) keyword (#8)
• Fixed greedy tokenization of \ in block strings (error when tokenizing [[\]])

Added

• Allow passing in options in erde.compile
• Allow disabling caching source maps
• Added erde sourcemap command to CLI help

Removed

• Remove self shorthand $. Completely unnecessary and confusing.
• Remove main keyword. Completely unnecessary and confusing.
• Remove ternary / null coalescing operator
  • Ternary created ambiguous syntax (a ? b:c() : d() vs a ? b : c():d())
  • Both difficult to optimize (requires iife)

Changed

• Refactor internal structure (now cleaner / faster)
• Use newline to differentiate syntax ambiguity
• No longer parse number destruct aliases as valid syntax
• Varargs now spreads when used as a table or param expression.
• Do not allow trailing comma in Return exprs unless parens are present
• erde.loader no longer mutates the global require function, but uses package.loaders (as it should)
• catch var no longer uses parentheses (more lua like)
• catch var can now be a destructure
• Array destructures can no longer be nested inside map destructures
• String interpolation is no longer supported for single quote strings
• The erde executable has been split into erde (interpreter) and erdec (compiler)
  • argparse does not allow arguments if subcommands are used, which means we
    could not do: erde myfile.erde to run a file. This was very unfriendly to
    scripts that may want to use a shebang with erde.
  • Use a similar structure as moonscript for familiarity.

Fixed

• Tokenizer now correctly consumes whitespace in string interpolation.
• String interpolation w/ names now compiles correctly.
• Parenthesized Return now parses correctly.
• Keywords are now allowed as named index chains (ex: x.if, y:else()).
• != operator is now actually compiled.
• OptChain now correctly parses optional method calls
• Fixed void return (i.e. no expressions)
• Parser / compiler no longer crash when the ast is empty

Removed

• BREAKING CHANGE: Removed try...catch statements
  • pcall paradigm suffices, try...catch statement in practice was not that useful
  • Do not want to split code styles on pcall vs try...catch
• Removed erdeXXX executables (erdejit, erde5.1, etc).
  • Did not realize luarocks wraps these Lua scripts and forces their running Lua version
  • Not as useful now that erde.load automatically infers the target
  • Polluted path a little bit (lots of executables, especially when installing for multiple versions)
• Removed -d, --debug cli option

Changed

• Erde now allows all number forms for all Lua targets and will transpile numbers to decimal format (including newly added binary literals).
• erde cli no longer requires the subcommand to appear directly after erde (flags in between are accepted)
• erde cli defaults compile and clean args to the current directory.
• Erde now throws an error when trying to call load with an invalid Lua target.
• Erde now overrides Lua's debug.traceback on load.
  • Can be disabled in load options using keep_traceback
  • Lua's native debug.traceback is restored when calling unload
• Erde now infers a version for load automatically based on _VERSION when one is not specified.
• Erde no longer catches and rethrows errors internally.
  • Previously used custom rethrown data type w/ __tostring metamethod, (overcomplicated, not user friendly)
  • Catching and rethrowing changes the call stack. Want to avoid this, as it causes confusion when debugging.
  • Still cannot handle the case when callbacks written in Erde but run in Lua throw errors.
  • Easier / simplest to have user handle error rewriting themselves at top level
    • Often times this will be automatically handled since we override debug.traceback on load
  • erde cli will still rewrite errors (repl and erde run)

Fixed

• Fixed compiling of chained function calls (ex. myfunc()())
• Erde now properly ignores escape sequences (except interpolation) in block strings ([[ ... ]])
• Fixed erde compile / clean checks for empty Lua files (is_compiled_file)
• Erde now properly rewrites source references in error messages (ex. xxx: in function <my_erde_file.erde:174>)
• Erde now properly checks for invalid varargs for arrow functions with implicit params
• Erde now properly injects the erde package loader when using the repl.

Added

• Allow binary literals (ex. print(0b100)) for all Lua targets.
• Allow strings to act as index chain bases without parentheses.
  • ex) 'mystring':find('my')
• Compiled files now include the version of Erde used at the bottom of the compiled file.
• Allow specifying bitlib in load options
• Added sourcemap subcommand for debugging

Changed

• CLI options now use all lowercase (more standard)
  • --outDir is now --outdir
  • --bitLib is now --bitlib
• Readline history no longer saves empty lines
• Parser now properly checks varargs scope (cannot be used outside vararg function)

Fixed

• Fixed module declarations with destructuring
• Long strings no longer throw errors for unrecognized escape chars (same behavior as Lua)
• Fixed determining ReturnList variants
• Fixed compile error when return arrow function return () -> { ... }
• Fixed readline history not saving
• Fixed ambiguous iife syntax in compiled Lua (inject semicolon)
• CLI now checks one extra character when looking for the compiled footer comment (handle trailing newlines injected by editor)

Added

• Added versioned executables to allow specifying the underlying lua executable version. Each additionally sets --target appropriately.
  • erde5.1 - sets --target 5.1 and uses lua5.1 executable
  • erde5.2 - sets --target 5.2 and uses lua5.2 executable
  • erde5.3 - sets --target 5.3 and uses lua5.3 executable
  • erde5.4 - sets --target 5.4 and uses lua5.4 executable
  • erdejit - sets --target jit and uses luajit executable
• Any arguments following a script to be run are now accessible in the script via the arg global (same behavior as Lua)
  • ex) erde myscript.erde "myscript_arg1"
• CLI now supports overwriting existing Lua files when compiling with -f, --force
• CLI now supports printing compiled code instead of writing to files with -p, --print (useful for debugging)

Removed

• Erde no longer depends on argparse

Added

• Added __tostring metamethod for thrown table errors (especially useful for sandboxed, embedded lua such as neovim)
• Added line numbers for errors when using erde compile
• Added REPL support
• Throw error when return statement is not the last statement in a block

Changed

• erde run no longer uses a subcommand
• erde compile and erde clean no longer default to cwd
• Improved error messages and error handling

Fixed

• Fix assignment operator compiled operation
• Fixed compilation error rewriting for asserts
• Fixed compilation of exponentiation operator for pre Lua5.3
• Fixed empty message when error does not have stacktrace
• Fixed C.BITLIB vs C.BIT_LIB inconsistencies
• Fixed empty file compilation
• Erde now substitutes variable names that are keywords in Lua but not in Erde (previously produced invalid Lua code)
• Erde now reports error lines at the start of the error (previously reported after)
• Erde now correctly preserves newlines following interpolations in long strings.
• Erde now correctly rewrites top level errors (previously always used main file source map)

Removed

• Removed do expressions.
• Removed spread operator.
• Removed optional chaining.
• Removed erde.loader (replaced by require('erde').load api)

Changed

• Reverted split of erde and erdec in favor of more pacman like "main flags".
• Improved erde --help output.
• erde now runs with the regular lua shebang (#!/usr/bin/env lua instead of #!/usr/bin/env luajit)

Added

• Erde now supports running on Lua 5.1+
• erde now accepts Lua targets to compile to, with specific Lua version compatabilities
• erde now accepts specifying a bit library to compile bit operations to
• Erde now generates souce maps and will rewrite errors when running scripts via the CLI or using erde.load.
• Several new apis have been added both to replace erde.loader and to allow for better error handling
  • erde.rewrite - rewrite Lua errors using a source map. Does a best-effort
    lookup for cached source map when one is not provided
  • erde.traceback - erde version of debug.traceback w/ line rewrites
  • erde.load - replacement for erde.loader, with an optional lua target
    as a parameter.
  • erde.unload - api to remove the injected erde loader (from a previous call
    to erde.load).

Initial Release