CHANGELOG.md

Changelog

Most changes are breaking changes.

Latest

• Move the bulk of the compiler to the acutis.internals library and make the acutis library a simple wrapper around it.

0.25.0

• Echo syntax is now the same as other expressions, {% and %}. Unescaped echoes use {{% and %}}.
• All decode errors are reported instead of only the first one.
• Decode errors are implemented in a promise type instead of raising an exception.

0.24.0

• Add the debug command --printinst to the CLI. This prints the new runtime instructions used by both the renderer and the JavaScript printer.
• Both the interpreted and compiled-to-JavaScript implementations use the same internal semantics now. This should not be a breaking change but may affect some edge cases or how errors are handled.

0.23.0

• Add JavaScript compilation. Templates can now compile to self-contained JavaScript files. This feature is supported in both the CLI and the Eleventy plugin.
• Change interface syntax to {% interface a=int %}. No closing / is needed.
• Change how the Eleventy plugin loads template functions so it's consistent between the different modes.
• Add debug commands to the CLI: --printast, --printtypes, and --printopt.
• Change the functor interface for the render module. Data modules only need to provide a few basic functions now.
• Support trailing commas in patterns.
• Improve dictionary pattern-matching. Dict patterns should match a subset of their input, with an empty dict always matching any input.

0.22.0

• Remove format specifier options. %i %f and %b do not take any flags now.
• Fix false positive "unused binding" error.
• Fix bug in decoding unknown tags in open tagged unions.
• Optimization: filter empty text nodes from final tree.

0.21.0

• Add . record access syntax: {{ book.title }}.
• Simplify the lexer.
• Support the unknown data type for function components.
• Calling a component with an extra prop is now a type error.

0.20.0

• Change escape syntax to {{{ }}}.
• Add format specifiers for echoing integers, floats, and boolean values.
• Remove the polymorphic "echoable" type.

0.19.0

• Make template blocks a first-class data type. Remove the child prop type that was previously used for them.
• Change template block syntax to begin and end with # (#%} block {%#).
• Add detection for unused bound variables.
• Make parser require a text node (%}...{%) separates each expression.

0.18.0

• Add Eleventy plugin.
• Distinguish filenames from component names when compiling components.

0.17.0

• Change interface syntax for consistency with other blocks.
• Fix bug with escaped quote characters in strings.

0.16.0

• Added interfaces. These allow you to optionally declare each template's types.
• Improved pattern-matching compilation. This fixed bugs and made the algorithm more robust.

0.15.0

• Acutis is rewritten in OCaml.
• The JavaScript output is now compiled with js_of_ocaml.
• The JavaScript API has completely changed.
• There is a new OCaml API.
• The language itself is the same, except for a few edge cases where the new parser behaves slightly differently.

0.14.0

• Acutis is now statically typed. This breaks all older templates.
• Added types:
  • Tuple.
  • Dictionary.
  • Enum.
  • Tagged union.
  • Unknown.
• Changed types:
  • Numbers are now either integers or floating points.
  • Boolean is a type of enum.
  • Records and lists (formerly called arrays) behave differently than before.
  • Nullable behaves more like an "option" type.
• Added syntax for new types.
• A new function map_dict now compliments the list map.
• Changed how external template functions work.
• Pattern matching compiles into decision trees.
• JavaScript API has almost completely changed.
• Changed license to MPL.
• There are many more changes than I can list here. See the updated docs for more information.

0.13.0

• Breaking change: invalid string escape sequences are now compile errors.
  • The only valid escape sequences currently are \\ and \".
• Fixed related escape sequence bugs.

0.12.0

• Added objects as a mappable type.

0.11.0

• Compile API changes:
  • Internal ASTs are now statically linked into directed acyclic graphs at compile time.
  • Circular template component dependencies are no longer allowed.
  • Components are compiled to an internal Compile.Components.t type.
  • Compile.fromArray is replaced with Compile.Components.make.
  • Compile.emptyMap is replaced with Compile.Components.empty.
  • Compile.make requires a second argument of Compile.Components.t type.
• Environments are no longer dynamically constructed from functions.
  • Environment.make function replaced with static Environment.sync.
  • Environment.Async.make function replaced with static Environment.async.

0.10.0

• New Source module with functions for classifying raw template sources.
• Template names are no longer optional.
• Results now use [#ok(_) | #errors(_)] type.
• New Result module with utility functions for using result types.
• Components are now stored in Belt.Map.String.t instead of Js.Dict.t.
• Compile.make now takes a Source.t. type.
• New Compile.fromArray creates a string map for components.
• Removed documentation for Compile.makeAst.
• ReScript: Added a public configuration to only export selected modules.
• Some public API functions changed from uncurried to curried¹:
  • Source.func function argument.
  • Source.funcWithString function argument.
  • env.mapChild function argument.
  • env.flatMapChild function argument.
• Upgraded ReScript to 9.0.1.

0.9.0

• Upgraded ReScript compiler to 9.0.
• Added ReScript standard library as a dependency.
• Removed JavaScript bundles. We now publish the compiled ReScript directly.
• Dropped Node 10 from testing and package.json engines. However, nothing else has changed yet that should stop Node 10 from working.

0.8.0

• Added ability to map static array patterns.
• Internal AST changes.

0.7.0

• Changed non-escape echo syntax: {% raw x %} is now {{ &x }}.
• & can be selectively used in ? chains: {{ a ? &b }}.
• Fixed bugs allowing binding to reserved words; made parser stricter overall.
• Internal AST changes.

0.6.0

• Added nullish coalescing to {{ echo }} and raw statements.
• ReScript: Changed namespace to AcutisLang.
• Added exports field to package.json
• Removed prebundled IIFE files.
• Minified all bundled files.

0.5.0

• Added acutis-lang binary as an alias for acutis.
• Removed TypeScript definitions. (They may be added back in the future.)
• Errors now have a path field for showing stack traces.
• Replaced the render function with a record containing functions:
  • render renders an AST.
  • return returns a string wrapped in the result type.
  • error returns an error.
  • mapChild uses a callback to transform a template child.
  • flatMapChild uses a callback to transform a template child without automatically wrapping it in a result type.
• Renamed Render.makeContext to Environment.make.
• Renamed Render.makeContextAsync to Environment.Async.make.
• Renamed several type names to better reflect their semantics.
• Function names are now consistent between ReScript and JavaScript.
  • JavaScript: renamed compile to Compile.make.
  • JavaScript: renamed makeAst to Compile.makeAst.
  • JavaScript: renamed renderContext to Environment.make.
  • JavaScript: renamed renderContextAsync to Environment.Async.make.

0.4.1

• Added description to package.json.

0.4.0

• Changed output from ReScript stdlib result type to a polymorphic variant.
• Removed JavaScript result function in favor of directly accessing the data structure.
• Made the exn field in the error record more type-safe by hiding its contents.

0.3.0

• Rewrote error handling.
  • Exceptions are no longer thrown.
  • Errors are more readable.
  • Rendered template output is returned in a ReScript result data type, which either contains the compiled output or an array of errors.
  • A JavaScript result function can convert the output into a format friendly for JavaScript environments.
• Improved detecting and reporting bad AST input.
• CLI: Added option to print errors with console.table.

0.2.1

• Fixed whitespace control to work on empty strings.
• Added license to bundled source files.

0.1.0

• Initial release

Footnotes

1. My measurements showed negligible performance differences. ↩