Changelog, versions 1.x.x

same as 1.20.1, but as Java version failed I need a new version number

sonar warnings

developer doc to add new languages

new organisation of language specific rules: per language classes vs switch/case everywhere, which will ease the addition of new languages

Java version now supports ouputData

updated Java version:

sonar alerts

github migration:

docker registry moved from registry.gitlab.com to hub.docker.com for cli, node.js server images and java server images

security update of dependencies

license change to Apache 2.0:

documentation in separate module rosaenlg-doc

updated logo (font is Soft Elegance)

code of conduct

bug in browser version of rosaenlg-packager

dependencies update (quite a lot of them)

getHasSaidCopy returns a copy of the hasSaid / recordSaid map as an object

in the API (lambda and node): added a outputData field so that specific computed data can be output by the API, and not only text

dependencies update

ability to complete or override default words and adjective lists in all languages

German dative definite article was wrong: denen instead of den

ROSAENLG_SHARED_DIR on node API to put shared templates in a separate folder

fixes 1.16.7 for DEFAULT_USER

in node API, when not using JWT, it is now possible to indicate which header contains the user

thanks to HB feedback: in English, new key useTheWhenPlural to output the when definite article in plural: #[+value('machine', {det:'DEFINITE', number:'P', useTheWhenPlural: true})] will output the machines

thanks to HB feedback: #[+subjectVerbAdj('machine', 'être', 'prêt', {det:'DEFINITE', number:'P'})] now produces les machines sont prêtes (instead of les machines est prêtes)

JSON schema is now enforced on input for Lambda API

stopword list was broken in the documentation

some errors in the swagger

larger timeout for lambda functions

countries library, for English and French

replaces 1.16.2 which had a little too much agressive contraction mechanism in French; always use 1.16.3 instead of 1.16.2.

in rosaenlg-packager, expandPackagedTemplateJson will transform a JSON packaged project into plain separate files

in swagger, added custom generic field

date contraction issues: de #[+value(new Date('1980-04-14'), {dateFormat:"MMMM"})] did output de avril instead of d’avril (in French)

security update of dependencies

node API and Lambda API: ability to set a user who has shared templates, which can be rendered by anyone

node API and Lambda API: render now also gives templateSha1 in the result

on both node.js and Lambda API:

in the prediction, corrected bug on empty element detection

Lambda API:

node.js API: CORS support

on the node.js API, reload is removed; now just using /templates/{templateId} will always try to reload and give the last SHA1 in the response

on both node.js and Lambda API, /templates/{templateId} will now systematically read on backend (and not use cache)

migration scripts in server-scripts folder

when rendering, in both node and lamba API: if the proper template/SHA1 is not in the cache but is found on backend, with a different SHA1: you now get a 308 redirect instead of an error (error was sha1 do not correspond, read sha1 is …​ while requested is …​)

French: in revamped module french-contractions:

clearer exception when value of something that is null or undefined

numerous tags now accept lists parameters instead of a single element, and will choose one randomly; use that feature instead of an embedded syn_fct call:

noSubject flag on subjectVerb and subjectVerbAdj mixins to silent the subject

verbs and adjectives are now properly extracted from subjectVerbAdj mixin, when embedding resources

there were sometimes inopportune ¤ in the html tags

there were spacing issues when parenthesis and quotes where mixed, like in bla ("bla") bla

Spanish support: verbs, words (gender, plural), adjectives, determiners

SEP_BEFORE and SEP_AFTER to provide separators when multiple adjectives; is practical to override default, e.g. value('árbol', { det:'DEFINITE', adj:{BEFORE:['primero', 'grande'], SEP_BEFORE:''} }) will generate el primer gran árbol

bug in BEFORE adjective list: value('homme', {det:'INDEFINITE', adj: { BEFORE:['vieux'] } }) now produces un vieil homme

bug in Lambda functions: forced embedded resources (in compile options) were ignored

bug in browser-ide-demo: JSON export was wrong (templateId in src and not a top level element)

bug in french-adjectives when adjective was placed before noun and plural: generated vieil alsaciens instead of vieux alsaciens

removed substantive mixin: use value instead with number param, see Value for Nominal Groups

english-ordinals is now a separate module

pluralize-fr removed from tiny runtime (automatically embeds a list of words with their plural instead)

french-adjectives is not embedded no more in tiny version (using lists instead)

doc organization for verb and value mixins

plugged to sonarqube, and thus some code style fixes

browser-ide-demo:

browser-ide-demo

in browser-ide-demo, save to compiled JavaScript with export option

fixed lambda create which did not save on S3 when the input already contained the compiled content

many changes in gulp-rosaenlg:

ability to include raw js files (e.g. include somejs.js), which is handy to be able to both lint and package these files in a json package

clearer exception and message when some raw js in the template is not properly compiled

gulp-rosaenlg now automatically includes all files to be included by reading the templates content

as a consequence, in the packageTemplateJson function:

dependencies update

removed sha1 external lib in favor of integrated crypto

dependencies update

rosaenlg-node-server issue in docker image

deprecated content-deduplicate and removed it from the repo

(almost) ready to deploy Lambda functions for AWS

common content for rosaenlg-node-server and rosaenlg-lambda in separate package rosaenlg-server-toolkit

tested (successfully) on different Node.js versions, see here

in pure rendering packages, essential libs were missing: numeral for all languages and french-adjectives for French, since 1.8.0

deprecated content-deduplicate

bullet lists for itemz and eachz, see doc

dynamic assemblies depending on the real length of non empty elements, also see doc

h1 h2 etc. were not considered as block level html elements

(much) better Italian ordinal support (up to 1 millions) thanks to Marco Riva

in value, use agree for ORDINAL_TEXTUAL in it_IT to have prima and not primo

rosaenlg-node-server: forgot to update docker tests

getRosaeNlgVersion() returns the version of RosaeNLG

rosaenlg-node-server: pre compiled templates are now accepted; when uploaded, templates are compiled only once and saved

rosaenlg-node-server: templates with include in subfolders had issues when importing

changed JSON packaging format, now separates src and comp fields

was able to analyze browser packages thanks to rollup-plugin-analyzer: removed a lot of unuseful stuff (particularly for rendering only packages)

big bug when choosebest was in an itemz structure; error message was choosebest cannot be imbricated

removed 2 patches thanks to n2words 1.3.2

more reliable a / an filtering in English: use of english-a-an and english-a-an-list instead of compromise in rosaenlg-filter

more reliable Englisn plurals: use of english-plurals and english-plurals-list instead of compromise

now using n2words for textual numbers in all languages, replacing written-number for French, write-int for German, compromise for English and italian-ordinals-cardinals for Italian textual

replaced compromise by n2words + custom code inspired by number-to-words for English ordinal numbers

completely removed compromise lib

added rosaenlg-parallel-poc in the repo to ease maintenance

added rosaenlg-browser-poc in the repo to ease maintenance

naming collisions on english-verbs on npm, renamed english-verbs-helper

en_US:

Italian and Other now available on browser IDE

use rollup.js to package (instead of browserify):

removed rosaenlg-pug-filters: brought few features and many security issues

package button in browser-ide

Rapid API documentation

mirror docker node.js server image on aws ecr

rosaenlg-node-server will now return a 404 on render when the template exists but the sha1 is not good

dependancies update

rosaenlg-node-server is now more ready to use on a cluster:

rosaenlg-node-server: lots of changes in the API, especially sha1 of the template is required to render a template (you get the sha1 when you load the template)

rosaenlg-node-server:

rosaenlg-node-server:

do not use 1.6.0 as there was an issue in rosaenlg-node-server: winston must not be devDependancy

rosaenlg-node-server:

rosaenlg-node-server:

rosaenlg-node-server:

rosaenlg-node-server: when using persistent templates, templates were not reloaded when server was restarted

rosaenlg-node-server: http codes are now more precise; like in Return 404 instead of 500 when template does not exist

rosaenlg-node-server: reload now uses PUT http method, and not GET no more

removed snyk dependancy

quotes ("…​") are now properly managed in terms of spacing

removed filter mixin: everything is filtered by default; use protect mixin to protect sections you don’t want to filter

removed disableFiltering option

in rosaenlg-node-server: ability to render a template directly, by sending the template and the data in the same request

the "missing space" issue, which lead to add lines with just | or | #{''}, is fixed (which is indeed a very good thing)

§…​§ structure is deprecated: please use protect tag instead which better cares for spacing

in rosaenlg-node-server: removed counter in the response (didn’t work properly, and was not really interesting)

new additional independant module content-deduplicate; it is not used by RosaeNLG while rendering texts but you can use it afterwards to assess the quality of your texts

in synonym global optimisation: html tags div p etc. are not considered no more as words; this can bring regressions on your projects, as synonyms are better chosen

French is better tokenized when there are apostrophes in the text

dependancies update

list of standard stop words in the documentation

Developer experience documentation

with CLI, templates can now be rendered in stdout (not systematically in a file)

compare with xSpin

examples of templates showing the added value of a Natural Language Generator compared to a plain template engine like Pug

itemz and eachz can be used with parameters: default will be {}

rosaenlg-cli used to output in files by default; now by default it outputs in stdout; add --out=./ to output in files as before

docker images (command line interface and server) are not built through main CI and available here

browser-ide-demo is now a package of the project

rosaenlg-node-server was not able to find openApiDocumentation_merged.json as path was not relative

rosaengl-cli (the command line interface):

rosaengl-node-server (server based on RosaeNLG):

removed @types/random-js dependancy which made a warning

NlgLib is now exposed. Useful when using compileFile (e.g. import {compileFile, NlgLib} from 'rosaenlg'),and mandatory for rosaenlg-node-server.

update of many dependancies

large reorganization of the documentation

more doc on how to integrate, Java Wrapper, Java Server etc.

#[+value('some string')] didn’t work no more

in the browser files supporting compilation (\_comp.js), there was only the render function; added compile, compileFile, compileClient, compileFileClient, renderFile and an access to NlgLib

in gulp-rosaenlg, packageTemplateJson to bundle templates and included templates in a single Json file

removed 'fat js' version (was huge, long to produce & not really useful)

fat js is still as fat but at least works now.

fat js packaged version, with compilation ability on each language, to be used in GraalVM

recordSaid hasSaid and deleteSaid existed to safely record booleans; now there is recordValue getValue and deleteValue to safely record numbers or strings

compare with CoreNLG in the documentation

GraalVM runtime documentation

Dev dependancies security issues thanks to Snyk

More French contractions (j’ai, lorsqu’il, puisqu’elle, jusqu’à etc.) thanks to CoreNLG source code

new synonym mode once: will trigger each alternative randomly, but will try to trigger each one only once. Just use it instead of random!

README.md is back for npmjs.com

in French, on browser package, composed tenses raised an error, because verbs that always take ETRE aux were not correctly packaged

reduced size on npm thanks to .npmignore

when using subjectVerb in French, when aux is ETRE, the participle is automatically agreed with the subject

1.0.1 broke gulp-rosaenlg. Removed more deeply dependancy with uglify (which was used by Pug pre-RosaeNLG).

Browser compilation was broken. Fix + added automated tests.

search engine available in RosaeNLG doc thanks to Algolia DocSearch (awesome product and support btw)

outdated packages (yarn outdated) replaced by newer version

1.0.0 version at last!