@sap/cds-compiler 2.12.0 → 2.15.2

package/CHANGELOG.md

@@ -7,6 +7,212 @@
 Note: `beta` fixes, changes and features are usually not listed in this ChangeLog but [here](doc/CHANGELOG_BETA.md).
 The compiler behavior concerning `beta` features can change at any time without notice.
 
+
+## Version 2.15.2 - 2022-05-12
+
+### Fixed
+
+- Option `cdsHome` can be used instead of `global.cds.home` to specify the path to `@sap/cds/`.
+- to.edm(x):
+  + Set anonymous nested proxy key elements to `Nullable:false` until first named type is reached.
+  + Enforce `odata-spec-violation-key-null` on explicit foreign keys of managed primary key associations.
+  + Proxies/service cross references are no longer created for associations with arbitrary ON conditions.
+    Only managed or `$self` backlink association targets are proxy/service cross reference candidates.
+  + Explicit foreign keys of a managed association that are not a primary key in the target are exposed in the the proxy.
+  + If an association is primary key, the resulting navigation property is set to `Nullable:false` in structured mode.
+
+## Version 2.15.0 - 2022-05-06
+
+### Added
+
+- A new warning is emitted if `excluding` is used without a wildcard, since this does
+  not have any effect.
+- All scalar types can now take named arguments, e.g. `MyString(length: 10)`.
+  For custom scalar types, one unnamed arguments is interpreted as length, two arguments are interpreted
+  as precision and scale, e.g. `MyDecimal(3,3)`.
+- If the type `sap.common.Locale` exists, it will be used as type for the `locale` element
+  of generated texts entities.  The type must be a `cds.String`.
+- to.cdl: Extend statements (from `extensions`) can now be rendered.
+- Add OData vocabulary 'Hierarchy'.
+- CDL: New associations can be published in queries, e.g. `assoc : Association to Target on assoc.id = id`
+
+### Changed
+
+- to.edm(x):
+  + perform inbound qualification and spec violation checks as well as most/feasible EDM preprocessing steps
+    on requested services only.
+  + Open up `@odata { Type, MaxLength, Precision, Scale, SRID }` annotation.  
+    The annotations behavior is defined as follows:
+    + The element/parameter must have a scalar CDS type. The annotation is not applied on named types
+      (With the V2 exception where derived type chains terminating in a scalar type are resolved).
+    + The value of `@odata.Type` must be a valid `EDM` type for the rendered protocol version.
+    + If `@odata.Type` can be applied, all canonic type facets (`MaxLength`, `Precision`, `Scale`, `SRID`) are
+      removed from the Edm Node and the new facets `@odata { MaxLength, Precision, Scale, SRID }` are applied.
+      Non Edm type conformant facets are ignored (eg. `@odata { Type: 'Edm.Decimal', MaxLength: 10, SRID: 0 }`).
+    + Type facet values are not evaluated.
+  + V2: Propagate `@Core.MediaType` annotation from stream element to entity type if not set.
+- to.edm: Render constant expressions in short notation.
+- Update OData Vocabularies: 'Common', 'Graph', 'Validation'.
+
+### Fixed
+
+- to.cdl:
+  + Annotations of elements of action `returns` are now rendered as `annotate` statements.
+  + Annotations on columns (query sub-elements) were not always rendered.
+  + Doc comments on bound actions were rendered twice.
+  + Unapplied annotations for action parameters were not rendered.
+  + Unions and joins are correctly put into parentheses.
+  + Add parentheses around certain expressions in function bodies that require it, such as `fct((1=1))`.
+- to.edm(x):
+  + Fix a bug in top level and derived type `items` exposure leading to undefined type rendering.
+  + Fix a naming bug in type exposure leading to false reuse types, disguising invididual type
+    modifications (such as annotations, (auto-)redirections, element extensions).
+  + Ignore `@Aggregation.default`.
+  + Consolidate message texts and formatting.
+  + Fix navigation property binding in cross service rendering mode.
+  + Remove partner attribute in proxy/cross service navigations.
+- Core engine (function `compile`):
+  + Annotations for new columns inside `extend projection` blocks were not used.
+  + Extending an unknown select item resulted in a crash.
+  + Extending a context/service with columns now correctly emits an error.
+  + Unmanaged `redirected to` in queries did not check whether the source is an association.
+- parseCdl: `extend <art> with enum {...}` incorrectly threw a compiler error.
+- API: `compile()` used a synchronous call `fs.realpathSync()` on the input filename array.  
+  Now the asynchronous `fs.realpath()` is used.
+- On-conditions in localized convenience views may be incorrectly rewritten if an element
+  has the same as a localized entity.
+- to.sql/hdi/hdbcds:
+  + No referential constraint is generated for an association if its parent
+  or target entity are annotated with `@cds.persistence.exists: true`.
+  + Fix rendering of virtual elements in subqueries
+  + Correctly process subqueries in JOINs
+- to.sql/hdi: Queries with `UNION`, `INTERSECT` and similar in expressions are now enclosed in parentheses.
+
+## Version 2.14.0 - 2022-04-08
+
+### Added
+
+- cdsc:
+  + `--quiet` can now be used to suppress compiler output, including messages.
+  + `--options <file.json>` can be used to load compiler options. A JSON file is expected. Is compatible to CDS `package.json`
+    and `.cdsrc.json` by first looking for `cdsc` key in `cds`, then for a `cdsc` key and otherwise uses the full JSON file.
+  + `--[error|warn|info|debug] id1,id2` can be used to reclassify specific messages.
+- Add OData Vocabularies: 'DataIntegration', 'JSON'.
+  
+### Changed
+
+- Update OData Vocabularies: 'UI'.
+
+### Fixed
+
+- to.cdl:
+  + Delimited identifiers as the last elements of arrays in annotation values are now
+    rendered with spaces in between, to avoid accidentally escaping `]`.
+  + Identifiers in includes and redirection targets were not quoted if they are reserved keywords.
+- to.edm(x): Correctly rewrite `@Capabilities.ReadRestrictions.ReadByKeyRestrictions` into
+  `@Capabilities.NavigationPropertyRestriction` in containment mode.
+
+## Version 2.13.8 - 2022-03-29
+
+### Fixed
+
+- to.hdbcds/hdi/sql: Correctly handle `localized` in conjunction with `@cds.persistence.exists` and `@cds.persistence.skip`
+
+## Version 2.13.6 - 2022-03-25
+
+### Fixed
+
+- to.hdbcds/hdi/sql: Correctly handle `localized` in conjunction with `@cds.persistence.exists`
+
+## Version 2.13.4 - 2022-03-22
+
+No changes compared to Version 2.13.0; fixes latest NPM tag
+
+## Version 2.13.2 - 2022-03-22
+
+No changes compared to Version 2.13.0; fixes latest NPM tag
+
+## Version 2.13.0 - 2022-03-22
+
+### Added
+
+- CDL syntax:
+  + Allow to `extend E:elem` and `annotate E:elem` instead of having to write deeply nested statements.
+  + Enable `default` values as part of scalar type definitions.
+  + The following `extend` syntax variants are now possible:
+    ```cds
+    extend … with elements { … }
+    extend … with definitions { … }
+    extend … with columns { … }
+    extend … with enum { … }
+    extend … with actions { … }
+    ```
+    This syntax expresses _how_ an artifact is extended instead of _what_ is extended.
+  + Using `ORDER BY` in generic functions such as SAP HANA's `first_value` is now possible.
+- Make API function `compileSources` accept CSN objects as file content
+- to.edm(x): Annotate view parameters with `@sap.parameter: mandatory` (V2) and `@Common.FieldControl: #Mandatory` (V4).
+- to.sql/hdi/hdbcds: Introduce the annotations `@sql.prepend` and `@sql.append` that allow inserting user-written SQL
+  snippets into the compiler generated content. Changes in annotations `@sql.prepend` and `@sql.append` are now reflected
+  in the output of `to.hdi.migration`. This enables CDS Build to produce `.hdbmigrationtable` files translating such model
+  changes into schema changes.
+- API: Lists of keywords for various backends are available as `to.<backend>[.<config>].keywords`, e.g. `to.sql.sqlite.keywords`.
+- for.odata/to.edm(x): The draft composition hull is now also taking into account compositions in subelements.
+
+### Changed
+
+- In query entities inside services, only auto-redirect associations and compositions
+  in the main query of the entity.
+- An element now inherits the property `notNull` from its query source (as
+  before) or its type (like it does for most other properties);
+  `notNull` is then not further propagated to its sub elements anymore.
+- A structure element inherits the property `virtual` from its query source (as
+  before), but does not further propagate `virtual` to its sub elements
+  (semantically of course, but the CSN is not cluttered with it);
+  there is a new warning if a previously `virtual` query entity
+  element is now considered to be non-virtual.
+- Do not propagate annotation value `null`.
+  The value `null` of an annotation (and `doc`) is used to stop the inheritance
+  of an annotation value.  This means than other than that, a value `null` should
+  not be handled differently to not having set that annotation.
+- In the effective CSN, the structure type is only expanded if something has changed
+  for associations: the `target` (`keys` does not change if the `target` does not change)
+  unmanaged associations as sub elements are not supported anyway.
+- In the effective CSN, “simple” type properties like `length`, `precision`,
+  `scale` and `srid` are propagated even for a propagation via type.
+- Update OData Vocabularies: 'Capabilities', 'Common', 'Core', 'UI'.
+- to.sql:
+  + For SQL dialect `hana` referential constraints are now appended
+    as `ALTER TABLE ADD CONSTRAINT` clause to the end of `schema.sql`.
+    With option `constraintsInCreateTable` constraints are rendered into the
+    `CREATE TABLE` statement.
+  + Referential constraint names are now prefixed with `c__`.
+
+### Fixed
+
+- Properly resolve references inside anonymous aspects:
+  + references starting with `$self.` made the compiler dump.
+  + a simple `$self` did  not always work as expected (it represents the entity created via the anonymous aspect).
+  + other references inside deeply nested anonymous aspects induced a compilation error.
+- compiler: `()` inside `ORDER BY` clause was not correctly set.
+- parse.cdl: References in `ORDER BY` and filters are now correctly resolved.
+- Issue error when trying to introduce managed compositions of aspects in `mixin`s
+- Issue error in all cases for type references to unmanaged associations.
+- Avoid dump when extending an illegal definition with a name starting with `cds.`.
+- to.sql/to.cdl/to.hdbcds/to.hdi: Render `cast()` inside `ORDER BY`, `GROUP BY` and `HAVING` properly.
+- to.sql/hdi/hdbcds:
+  + `$self` was incorrectly treated as a structured path step.
+  + Correctly handle table alias in on-condition of mixin in `exists` expansion.
+  + Correctly handle table `$self` references to aliased fields in on-condition of mixin association
+    during `exists` expansion.
+- to.edm: Don't escape `&` as `&amp;`.
+- to.edmx: Escaping compliant to XML specification:
+  + `&` and `<` are always escaped.
+  + `>` is not escaped, unless it appears in text values as `]]>`.
+  + `"` is escaped in attribute values only.
+  + Control characters are always escaped.
+- Ellipsis (`...`) in annotations in different layers but without base annotation now produces an error.
+  The old but incorrect behavior can be re-enabled with option `anno-unexpected-ellipsis-layers`.
+
 ## Version 2.12.0 - 2022-01-25
 
 ### Added
@@ -18,16 +224,16 @@ The compiler behavior concerning `beta` features can change at any time without
   for syntax highlighting, similar to markdown.  In difference to the former, text blocks require the
   opening and closing backticks to be on separate lines.
   Example:
+  ````
+  @annotation: `Multi
+   line\u{0020}strings`
 
-      @annotation: `Multi
-       line\u{0020}strings`
-  
-      @textblock: ```xml
-                  <summary>
-                    <detail>The root tag has no indentation in this example</detail>
-                  </summary>
-                  ```
-      ...
+  @textblock: ```xml
+              <summary>
+                <detail>The root tag has no indentation in this example</detail>
+              </summary>
+              ```
+  ````
 
 - Enhance the ellipsis operator `...` for array annotations by an `up to ‹val›`:
   only values in the array of the base annotation up to (including) the first match
@@ -38,12 +244,12 @@ The compiler behavior concerning `beta` features can change at any time without
   values in `‹val›` are equal to the corresponding property value in the array value;
   it is not necessary to specify all properties of the array value items in `‹val›`.
   Example
-
-      @Anno: [{name: one, val: 1}, {name: two, val: 2}, {name: four, val: 4}]
-      type T: Integer;
-      @Anno: [{name: zero, val: 0}, ... up to {name: two}, {name: three, val: 3}, ...]
-      annotate T;
-
+  ```
+  @Anno: [{name: one, val: 1}, {name: two, val: 2}, {name: four, val: 4}]
+  type T: Integer;
+  @Anno: [{name: zero, val: 0}, ... up to {name: two}, {name: three, val: 3}, ...]
+  annotate T;
+  ```
 - for.odata: Support `@cds.on {update|insert}` as replacement for deprecated `@odata.on { update|insert }` to
   set `@Core.Computed`.
 

package/bin/cdsc.js

@@ -44,6 +44,18 @@ class ProcessExitError extends Error {
   }
 }
 
+try {
+  cdsc_main();
+}
+catch (err) {
+  // This whole try/catch is only here because process.exit does not work in combination with
+  // stdout/err - see comment at ProcessExitError
+  if (err instanceof ProcessExitError)
+    process.exitCode = err.exitCode;
+  else
+    throw err;
+}
+
 function remapCmdOptions(options, cmdOptions) {
   if (!cmdOptions)
     return options;
@@ -73,6 +85,9 @@ function remapCmdOptions(options, cmdOptions) {
           options.variableReplacements.$user = {};
         options.variableReplacements.$user.locale = value;
         break;
+      case 'serviceNames':
+        options.serviceNames = value.split(',');
+        break;
       default:
         options[key] = value;
     }
@@ -80,8 +95,9 @@ function remapCmdOptions(options, cmdOptions) {
   return options;
 }
 
-// Parse the command line and translate it into options
-try {
+function cdsc_main() {
+  // Parse the command line and translate it into options
+
   const cmdLine = optionProcessor.processCmdLine(process.argv);
   // Deal with '--version' explicitly
   if (cmdLine.options.version) {
@@ -115,6 +131,11 @@ try {
     displayUsage(cmdLine.errors, optionProcessor.helpText, 2);
   }
 
+  if (cmdLine.options.options) {
+    if (!loadOptionsFromJson(cmdLine))
+      return;
+  }
+
   // Default warning level is 2 (info)
   // FIXME: Is that not set anywhere in the API?
   if (!cmdLine.options.warning)
@@ -125,11 +146,7 @@ try {
     cmdLine.options.out = '-';
 
   // --cds-home <dir>: modules starting with '@sap/cds/' are searched in <dir>
-  if (cmdLine.options.cdsHome) {
-    if (!global.cds)
-      global.cds = {};
-    global.cds.home = cmdLine.options.cdsHome;
-  }
+  // -> cmdLine.options.cdsHome is passed down to moduleResolve
 
   // Set default command if required
   cmdLine.command = cmdLine.command || 'toCsn';
@@ -147,8 +164,8 @@ try {
   if (cmdLine.options.directBackend)
     validateDirectBackendOption(cmdLine.command, cmdLine.options, cmdLine.args);
 
-
-  if (cmdLine.options.beta) {
+  // If set through CLI (and not options file), `beta` is a string and needs processing.
+  if (cmdLine.options.beta && typeof cmdLine.options.beta === 'string') {
     const features = cmdLine.options.beta.split(',');
     cmdLine.options.beta = {};
     features.forEach((val) => {
@@ -156,43 +173,32 @@ try {
     });
   }
 
+  const to = cmdLine.options.toSql ? 'toSql' : 'toHana';
   // remap string values for `assertIntegrity` option to boolean
-  if (cmdLine.options.assertIntegrity &&
-      cmdLine.options.assertIntegrity === 'true' ||
-      cmdLine.options.assertIntegrity === 'false'
-  )
-    cmdLine.options.assertIntegrity = cmdLine.options.assertIntegrity === 'true';
-
-  // remap string values for `constraintsAsAlter` option to boolean
-  if (cmdLine.options.constraintsAsAlter &&
-    cmdLine.options.constraintsAsAlter === 'true' ||
-    cmdLine.options.constraintsAsAlter === 'false'
+  if (cmdLine.options[to] && cmdLine.options[to].assertIntegrity &&
+     (cmdLine.options[to].assertIntegrity === 'true' ||
+      cmdLine.options[to].assertIntegrity === 'false')
   )
-    cmdLine.options.constraintsAsAlter = cmdLine.options.constraintsAsAlter === 'true';
-
+    cmdLine.options[to].assertIntegrity = cmdLine.options[to].assertIntegrity === 'true';
 
   // Enable all beta-flags if betaMode is set to true
   if (cmdLine.options.betaMode)
     cmdLine.options.beta = availableBetaFlags;
 
-  if (cmdLine.options.deprecated) {
+  // If set through CLI (and not options file), `deprecated` is a string and needs processing.
+  if (cmdLine.options.deprecated && typeof cmdLine.options.deprecated === 'string') {
     const features = cmdLine.options.deprecated.split(',');
     cmdLine.options.deprecated = {};
     features.forEach((val) => {
       cmdLine.options.deprecated[val] = true;
     });
   }
+
+  parseSeverityOptions(cmdLine);
+
   // Do the work for the selected command
   executeCommandLine(cmdLine.command, cmdLine.options, cmdLine.args);
 }
-catch (err) {
-  // This whole try/catch is only here because process.exit does not work in combination with
-  // stdout/err - see comment at ProcessExitError
-  if (err instanceof ProcessExitError)
-    process.exitCode = err.exitCode;
-  else
-    throw err;
-}
 
 /**
  * `--direct-backend` can only be used with certain backends and with certain files.
@@ -238,10 +244,10 @@ function displayUsage(error, helpText, code) {
 function executeCommandLine(command, options, args) {
   const normalizeFilename = options.testMode && process.platform === 'win32';
   const messageLevels = {
-    Error: 0, Warning: 1, Info: 2, None: 3,
+    Error: 0, Warning: 1, Info: 2, Debug: 3,
   };
   // All messages are put into the message array, even those which should not
-  // been displayed (severity 'None')
+  // been displayed (severity 'Debug')
 
   // Create output directory if necessary
   if (options.out && options.out !== '-' && !fs.existsSync(options.out))
@@ -337,17 +343,18 @@ function executeCommandLine(command, options, args) {
       options.toOdata.odataContainment = true;
     }
     const csn = options.directBackend ? model : compactModel(model, options);
-    const odataCsn = main.for.odata(csn, remapCmdOptions(options, options.toOdata));
+    const odataOptions = remapCmdOptions(options, options.toOdata);
     if (options.toOdata && options.toOdata.csn) {
+      const odataCsn = main.for.odata(csn, odataOptions);
       displayNamedCsn(odataCsn, 'odata_csn');
     }
     else if (options.toOdata && options.toOdata.json) {
-      const result = main.to.edm.all(odataCsn, options);
+      const result = main.to.edm.all(csn, odataOptions);
       for (const serviceName in result)
         writeToFileOrDisplay(options.out, `${serviceName}.json`, result[serviceName]);
     }
     else {
-      const result = main.to.edmx.all(odataCsn, options);
+      const result = main.to.edmx.all(csn, odataOptions);
       for (const serviceName in result)
         writeToFileOrDisplay(options.out, `${serviceName}.xml`, result[serviceName]);
     }
@@ -452,10 +459,10 @@ function executeCommandLine(command, options, args) {
    * Print the model's messages to stderr in a human readable way.
    *
    * @param {CSN.Model | XSN.Model} model
-   * @param {CSN.Message[]} messages
+   * @param {CompileMessage[]} messages
    */
   function displayMessages( model, messages = options.messages ) {
-    if (!Array.isArray(messages))
+    if (!Array.isArray(messages) || options.quiet)
       return model;
 
     const log = console.error;
@@ -483,7 +490,6 @@ function executeCommandLine(command, options, args) {
         hasAtLeastOneExplanation = hasAtLeastOneExplanation || main.hasMessageExplanation(msg.messageId);
         const name = msg.location && msg.location.file;
         const fullFilePath = name ? path.resolve('', name) : undefined;
-        const context = fullFilePath ? sourceLines(fullFilePath) : [];
         log(main.messageStringMultiline(msg, {
           normalizeFilename,
           noMessageId: !options.showMessageId,
@@ -491,8 +497,12 @@ function executeCommandLine(command, options, args) {
           hintExplanation: true,
           color: options.color,
         }));
-        if (context)
+        if (fullFilePath && msg.location.col) {
+          // A message context only makes sense, if we have at least a medium precision,
+          // i.e. line and column for start position.
+          const context = sourceLines(fullFilePath);
           log(main.messageContext(context, msg, { color: options.color }));
+        }
         log(); // newline
       });
       if (options.showMessageId && hasAtLeastOneExplanation)
@@ -557,8 +567,15 @@ function executeCommandLine(command, options, args) {
       content = JSON.stringify(content, null, 2);
 
     if (dir === '-') {
-      if (!omitHeadline)
-        process.stdout.write(`// ------------------- ${fileName} -------------------\n`);
+      if (options.quiet)
+        return;
+      if (!omitHeadline) {
+        const sqlTypes = {
+          sql: true, hdbconstraint: true, hdbtable: true, hdbview: true,
+        };
+        const commentStarter = fileName.split('.').pop() in sqlTypes ? '--$' : '//';
+        process.stdout.write(`${commentStarter} ------------------- ${fileName} -------------------\n`);
+      }
 
       process.stdout.write(`${content}\n`);
       if (!omitHeadline)
@@ -569,15 +586,73 @@ function executeCommandLine(command, options, args) {
       fs.writeFileSync(path.join(dir, fileName), content);
     }
   }
+}
+
+function loadOptionsFromJson(cmdLine) {
+  try {
+    let opt = JSON.parse(fs.readFileSync(cmdLine.options.options, 'utf-8'));
+    if (opt.cds)
+      opt = opt.cds;
+    if (opt.cdsc)
+      opt = opt.cdsc;
+    Object.assign(cmdLine.options, opt);
+    return true;
+  }
+  catch (e) {
+    catchErrors(e);
+    return false;
+  }
+}
 
-  function catchErrors(err) {
-    // @ts-ignore
-    if (err instanceof Error && err.hasBeenReported)
-      return;
-    console.error( '' );
-    console.error( 'INTERNAL ERROR:' );
-    console.error( util.inspect(err, false, null) );
-    console.error( '' );
-    process.exitCode = 70;
+function catchErrors(err) {
+  // @ts-ignore
+  if (err instanceof Error && err.hasBeenReported)
+    return;
+  console.error( '' );
+  console.error( 'INTERNAL ERROR:' );
+  console.error( util.inspect(err, false, null) );
+  console.error( '' );
+  process.exitCode = 70;
+}
+
+/**
+ * Parses the options `--error` and similar.
+ * Sets the dictionary `severities` on the given options.
+ *
+ * @param {object} options
+ */
+function parseSeverityOptions({ options }) {
+  if (!options.severities)
+    options.severities = Object.create(null);
+
+  const severityMap = {
+    error: 'Error',
+    warn: 'Warning',
+    info: 'Info',
+    debug: 'Debug',
+  };
+
+  // Note: We use a for loop to ensure that the order of the options on the command line is respected, i.e.
+  //      `--warn id --error id` would lead to `id` being reclassified as an error and not a warning.
+  for (const key in options) {
+    switch (key) {
+      case 'error':
+      case 'warn':
+      case 'info':
+      case 'debug':
+        parseSeverityOption(options[key], severityMap[key]);
+        break;
+      default:
+        break;
+    }
+  }
+
+  function parseSeverityOption(list, severity) {
+    const ids = list.split(',');
+    for (let id of ids) {
+      id = id.trim();
+      if (id)
+        options.severities[id] = severity;
+    }
   }
 }

package/bin/cdsse.js

@@ -144,8 +144,8 @@ function lint( err, buf ) {
   }
 }
 
-function tokensAt( buf, offset, col, symbol ) {
-  const src = `${buf.substring( 0, offset )}≠${buf.substring( offset )}`;
+function tokensAt( buf, _offset, col, symbol ) {
+  const src = `${buf.substring( 0, _offset )}≠${buf.substring( _offset )}`;
   const et = messageAt( compiler.parseX( src, frel, { messages: [] } ), 'expectedTokens', col ) || [];
   for (const n of et) {
     if (typeof symbol === 'string') {

package/doc/CHANGELOG_BETA.md

@@ -8,23 +8,30 @@ Note: `beta` fixes, changes and features are listed in this ChangeLog just for i
 The compiler behavior concerning `beta` features can change at any time without notice.
 **Don't use `beta` fixes, changes and features in productive mode.**
 
+## Version 2.XX.YY
+
+### Removed `assocsWithParams`
+
+Instead, of using the beta flag `assocsWithParams`, you can change the severity of the messages
+`def-unexpected-paramview-assoc` and `def-unexpected-calcview-assoc`.
+
 ## Version 2.12.0 - 2022-01-25
 
 ### Added `sqlSnippets`
 
 - to.sql/hdi/hdbcds: Introduce the annotations `@sql.prepend` and `@sql.append` that allow inserting user-written SQL snippets into the compiler generated content.
 
-## Version 2.11.0
+## Version 2.11.0 - 2021-12-02
 
 ### Removed `foreignKeyConstraints`
 
-## Version 2.10.4
+## Version 2.10.4 - 2021-11-05
 
 ### Fixed `nestedProjections`
 
 - to.sql/hdi/hdbcds: Correctly handle a `*` at the not-first place in the query
 
-## Version 2.6.0
+## Version 2.6.0 - 2021-08-23
 
 ### Removed `pretransformedCSN`
 
@@ -48,7 +55,7 @@ This is now the default - see CHANGELOG entry for 2.6.0
 - Composition of one w/o backlink will result in a constraint in
   the entity where the composition is defined
 
-## Version 2.4.4
+## Version 2.4.4 - 2021-07-02
 
 ### Added `nestedProjections`
 
@@ -59,7 +66,7 @@ This is now the default - see CHANGELOG entry for 2.6.0
 - _Some checks are missing and will be added! Minor changes might occur._
 - **The SQL backends might not work properly yet if nested projections are used!**
 
-## Version 2.4.2
+## Version 2.4.2 - 2021-07-01
 
 ### Added `keylessManagedAssoc`
 
@@ -71,7 +78,7 @@ This is now the default - see CHANGELOG entry for 2.6.0
   Consequently, these associations are not added to the `WITH ASSOCIATIONS` clause or forwarded to HANA CDS.
   Managed Associations without foreign keys must be enabled with `--beta: keylessManagedAssoc`
 
-## Version 2.4.0
+## Version 2.4.0 - 2021-06-28
 
 ### Changed `foreignKeyConstraints`