Skip to content

CHANGELOG.md

Latest commit

 

History

History
86 lines (51 loc) · 4.7 KB

CHANGELOG.md

File metadata and controls

86 lines (51 loc) · 4.7 KB

EFX Toolkit 2.0.0-alpha.6 Release Notes

The EFX Toolkit for Java developers is a library that enables the transpilation of EFX expressions and templates to different target languages. It also includes an implementation of an EFX-to-XPath transpiler.

In this release

This is a major update that brings the toolkit in line with the complete EFX-2 grammar as released with SDK 2.0.0-alpha.2.

EFX-2 language support

  • Implemented all new EFX-2 language features introduced in SDK 2.0.0-alpha.2. See the SDK changelog for the full list.

EFX Rules translator

  • Added a new EFX Rules to Schematron translator, enabling business rules authored in EFX to be transpiled into Schematron validation schemas.
  • Rules that apply to all notice subtypes are deduplicated into a shared Schematron pattern.
  • New ValidatorGenerator interface for Schematron output generation.

Dependency analysis

  • Added dependency extractors for EFX rules, producing dependency graphs that track field, codelist, and variable references.

Template translator

  • Dictionary lookups are now translated using XSL keys for better performance.
  • Profiling and timing support for template translation via new TranslatorOptions methods.

EFX autocomplete API

  • Added an autocomplete API for code editors, providing completion items for EFX keywords, built-in functions, and field properties.

New interfaces and classes

  • ValidatorGenerator: Interface for generating validation output (Schematron).
  • TranslatorContext: Interface providing translation context to MarkupGenerator methods.
  • TypeChecker: Interface for SDK-specific type validation.
  • IncludedFileResolver: Interface for resolving #include directives in EFX files.
  • New typed exception hierarchy: EfxCompilationException, InvalidArgumentException, InvalidIdentifierException, InvalidIndentationException, InvalidUsageException, SdkInconsistencyException, SymbolResolutionException, TranslatorConfigurationException, TypeMismatchException.

Bug fixes

  • Fixed invalid XPath in typed uniqueness conditions.
  • Fixed quote escaping in string literals.

EFX-1 Support

Although this is a pre-release version of the EFX Toolkit, it provides production-level support for EFX-1 transpilation. EFX-1 is the current version of EFX released with SDK 1.

NOTE: Transpilation of EFX-1 to XPath and XSL in this version of the EFX Toolkit is better than what is provided by EFX Toolkit 1.3.0.

Breaking changes

For users of the Toolkit that have implemented custom transpilers, this release contains breaking changes from 2.0.0-alpha.5:

  • The expression model has been refactored to separate scalar and sequence types. The path subpackage has been removed and path expression types have been moved and renamed (e.g. BooleanPathExpression → BooleanPath under scalar).
  • MarkupGenerator.composeOutputFile signature changed from 2 parameters to 5 (globals, main section, summary section, navigation section, fragments). The old signature is deprecated with a default implementation.
  • Several new methods have been added to the SymbolResolver, ScriptGenerator, and MarkupGenerator interfaces.
  • TranslatorOptions has three new methods without defaults: getUserDefinedFunctionNamespace(), isProfilerEnabled(), getProfilerOutputPath().
  • New typed exception classes replace previously generic exceptions.
  • Axis support and cross-notice references have been removed from the V2 translator.

Users of the Toolkit that only use the included EFX-to-XPath transpiler will not be affected by the above changes.

Future development

Further alpha and beta releases of SDK 2 and EFX Toolkit 2 will be issued. While in "alpha" development stage, further breaking changes may be introduced.

You can download the latest EFX Toolkit from Maven Central. Maven Central

Documentation for the EFX Toolkit is available at: https://docs.ted.europa.eu/eforms/latest/efx-toolkit

This version of the EFX Toolkit has a compile-time dependency on the following eForms SDK versions and uses the EFX grammar that each version provides:

  • eForms SDK 1.x.x (SDK 1.13.0 grammar)
  • eForms SDK 2.0.0-alpha.2

It also depends on the eForms Core Java library version 1.6.0.

NOTE: The POM currently references SNAPSHOT versions for the SDK 2 and Core dependencies. These will be updated to released versions before publication.