@sap/cds-compiler 4.0.2 → 4.2.2

package/lib/language/language.g4

@@ -216,7 +216,7 @@ usingProxy[ outer, proxy ]
     )
   ;
 
-artifactDefOrExtend[ outer, defOnly = false ] locals[ art = {} ] // cannot use `parent` as parameter name!
+artifactDefOrExtend[ outer, defOnly = false ] locals[ art = new parser.XsnArtifact() ] // cannot use `parent` as parameter name!
 @after{ /* #ATN 1 */ }
   :
     { $art.location = this.startLocation(); this.docComment( $art ); }
@@ -285,13 +285,13 @@ optionalSemi
 
 // Annotation def and main definitions ------------------------------------------
 
-annotationDef[ art, outer ] locals[ name = {} ]
+annotationDef[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     annotation=ANNOTATION simplePath[ $name, 'AnnoDef' ]
     { if ($outer.kind !== 'source') { // this is a syntax restriction to avoid confusion
         this.error( 'syntax-unexpected-vocabulary', $annotation, { '#': $outer.kind } );
-        $art = {}; }
+        $art = new this.XsnArtifact(); }
       else {
         if (!$outer.vocabularies) $outer.vocabularies = Object.create(null);
         this.addDef( $art, $outer, 'vocabularies', 'annotation', $name );
@@ -301,7 +301,7 @@ annotationDef[ art, outer ] locals[ name = {} ]
     typeSpecSemi[ $art ] // also 'includes'...
   ;
 
-serviceDef[ art, outer, defOnly = false ] locals[ name = {} ]
+serviceDef[ art, outer, defOnly = false ] locals[ name = new parser.XsnName(); ]
 @after { this.attachLocation( $art ); }
   :
     SERVICE simplePath[ $name, 'Service' ]
@@ -309,7 +309,7 @@ serviceDef[ art, outer, defOnly = false ] locals[ name = {} ]
     optArtifactsBlock[ $art, defOnly ]
   ;
 
-contextDef[ art, outer, defOnly = false ] locals[ name = {} ]
+contextDef[ art, outer, defOnly = false ] locals[ name = new parser.XsnName(); ]
 @after { this.attachLocation( $art ); }
   :
     CONTEXT simplePath[ $name, 'Context' ]
@@ -317,7 +317,7 @@ contextDef[ art, outer, defOnly = false ] locals[ name = {} ]
     optArtifactsBlock[ $art, defOnly ]
   ;
 
-eventDef[ art, outer ] locals[ name = {} ]
+eventDef[ art, outer ] locals[ name = new parser.XsnName(); ]
 @after { /* #ATN 1 */ this.attachLocation( $art ); }
   :
     EVENT simplePath[ $name, 'Event' ]
@@ -353,7 +353,7 @@ eventDef[ art, outer ] locals[ name = {} ]
     )
   ;
 
-viewDef[ art, outer ] locals[ name = {} ]
+viewDef[ art, outer ] locals[ name = new parser.XsnName(); ]
 @after { this.attachLocation( $art ); }
   :
     v=VIEW simplePath[ $name, 'Entity' ]
@@ -376,7 +376,7 @@ viewDef[ art, outer ] locals[ name = {} ]
     requiredSemi
   ;
 
-entityDef[ art, outer ] locals[ name = {} ]
+entityDef[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     ENTITY simplePath[ $name, 'Entity' ]
@@ -424,7 +424,7 @@ entityDef[ art, outer ] locals[ name = {} ]
     )
   ;
 
-aspectDef[ art, outer ] locals[ name = {} ]
+aspectDef[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     ( ASPECT | ( abs=ABSTRACT | HideAlternatives ) ent=ENTITY )
@@ -453,12 +453,11 @@ aspectDef[ art, outer ] locals[ name = {} ]
       )?
       optionalSemi
     | // `aspect MyAspect;`, e.g. for annotation aspects.
-      { this.aspectWithoutElements( $art ); }
       requiredSemi
     )
   ;
 
-typeDef[ art, outer ] locals[ name = {} ]
+typeDef[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     TYPE simplePath[ $name, 'Type' ]
@@ -468,7 +467,7 @@ typeDef[ art, outer ] locals[ name = {} ]
     typeSpecSemi[ $art ]
   ;
 
-actionFunctionMainDef[ art, outer ] locals[ name = {} ]
+actionFunctionMainDef[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     ACTION simplePath[ $name, 'Action' ]
@@ -488,7 +487,7 @@ actionFunctionMainDef[ art, outer ] locals[ name = {} ]
 
 // Member definitions: actions, elements, enums, parameters: --------------------
 
-actionFunctionDef[ outer ] locals[ art = {} ]
+actionFunctionDef[ outer ] locals[ art = new parser.XsnArtifact() ]
 @after { this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -510,7 +509,7 @@ actionFunctionDef[ outer ] locals[ art = {} ]
     )
   ;
 
-parameterDef[ outer ] locals[ art = {} ]
+parameterDef[ outer ] locals[ art = new parser.XsnArtifact() ]
 @after { this.attachLocation( $art ); }
   :
     { this.meltKeywordToIdentifier();; this.docComment( $art ); }
@@ -546,7 +545,7 @@ parameterListDef[ art ]
     ')' { this.finalizeDictOrArray( $art.params ); }
   ;
 
-enumSymbolDef[ outer ] locals[ art = {} ]
+enumSymbolDef[ outer ] locals[ art = new parser.XsnArtifact() ]
 @after { this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -570,14 +569,14 @@ enumSymbolDef[ outer ] locals[ art = {} ]
     requiredSemi
   ;
 
-elementDef[ outer ] locals[ $art = {} ]
+elementDef[ outer ] locals[ $art = new parser.XsnArtifact() ]
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
     annotationAssignment_ll1[ $art ]*
-    elementDefInner[ $art, $outer, false ]
+    elementDefInner[ $art, $outer ]
   ;
 
-elementDefInner[ art, outer, mightBeEnum ]
+elementDefInner[ art, outer, explicitElement = false ]
 @after{ this.attachLocation( $art ); }
   :
     // VIRTUAL is keyword, except if before the following tokens texts:
@@ -592,7 +591,7 @@ elementDefInner[ art, outer, mightBeEnum ]
       }
     )?
     { this.setLocalToken( 'ELEMENT', 'ELEMENT', /^[;:{@=}]$/ ); }
-    ( ELEMENT { $mightBeEnum = false; } )? // auto-recognizable at other places
+    ( ELEMENT { $explicitElement = true; } )? // auto-recognizable at other places
     name=ident['Element']
     { this.addDef( $art, $outer, 'elements', 'element', $name.id );
       this.docComment( $art ); }
@@ -605,7 +604,7 @@ elementDefInner[ art, outer, mightBeEnum ]
       )
     |
       ':'
-      elementType[ $art, $mightBeEnum ]
+      elementType[ $art ]
     |
       eq='=' e=expression       // SQL has syntax variant using AS - we DO NOT
       stored=STORED?
@@ -613,10 +612,8 @@ elementDefInner[ art, outer, mightBeEnum ]
         // this.setIntroLocation( eq );  -- future
         if ($stored)
           $art.value.stored = this.valueWithTokenLocation( true, $stored );
-        if ($mightBeEnum && !$stored &&
-            ($e.expr?.val !== undefined || $e.expr?.sym !== undefined) &&
-            !$virtual && !$key && !$masked && !$art.elements && !$art.type)
-          $art['$'+'syntax'] = 'enum';
+        if ($explicitElement)
+          $art['$'+'syntax'] = 'element';
       }
       { this.docComment( $art ); }
       annotationAssignment_ll1[ $art ]* // for enum symbol def via EXTEND
@@ -750,7 +747,7 @@ defaultValue[ art ] locals[ elem, elements = {} ]
 
 // Extend and annotate ----------------------------------------------------------
 
-extendArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
+extendArtifact[ art, outer ] locals[ name = new parser.XsnName(), elemName = new parser.XsnName() ]
 @after{ /* #ATN 1 */ this.attachLocation( $art ); }
   :
     simplePath[ $name, 'Extend' ]
@@ -771,7 +768,7 @@ extendArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
       (
         // all the alternatives from `extendWithOptElementsOrType` --------------
         '{' { $art.elements = this.createDict(); }
-        elementDefOrExtend[ $art, true ]*
+        elementDefOrExtend[ $art ]*
         '}' { this.finalizeDictOrArray( $art.elements ); }
         { this.checkExtensionDict( $art.elements ); }
         optionalSemi
@@ -779,7 +776,7 @@ extendArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
         requiredSemi
       |
         ELEMENTS { $art.elements = this.createDict(); } '{'
-        elementDefOrExtend[ $art ]*
+        elementDefOrExtend[ $art, true ]*
         '}' { this.finalizeDictOrArray( $art.elements ); }
         { this.checkExtensionDict( $art.elements ); }
         optionalSemi
@@ -823,7 +820,7 @@ extendArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
     )
   ;
 
-extendService[ art, outer ] locals[ name = {} ]
+extendService[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     SERVICE { $art.expectedKind = this.valueWithTokenLocation(); }
@@ -833,7 +830,7 @@ extendService[ art, outer ] locals[ name = {} ]
     optArtifactsBlock[ art, 'service' ]
   ;
 
-extendContext[ art, outer ] locals[ name = {} ]
+extendContext[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     CONTEXT { $art.expectedKind = this.valueWithTokenLocation(); }
@@ -843,7 +840,7 @@ extendContext[ art, outer ] locals[ name = {} ]
     optArtifactsBlock[ art, 'context' ]
   ;
 
-extendEntityOrAspect[ art, outer ] locals[ name = {} ]
+extendEntityOrAspect[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { /* #ATN 1 */ this.attachLocation( $art ); }
   :
     (ASPECT | ENTITY) { $art.expectedKind = this.valueWithTokenLocation(); }
@@ -888,7 +885,7 @@ extendForEntity[ art ]
     requiredSemi
   ;
 
-extendProjection[ art, outer ] locals[ name = {} ]
+extendProjection[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     PROJECTION { $art.expectedKind = this.valueWithTokenLocation( 'entity' ); }
@@ -924,7 +921,7 @@ extendProjection[ art, outer ] locals[ name = {} ]
     )
   ;
 
-extendType[ art, outer ] locals[ name = {} ]
+extendType[ art, outer ] locals[ name = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     TYPE { $art.expectedKind = this.valueWithTokenLocation(); }
@@ -940,7 +937,7 @@ extendType[ art, outer ] locals[ name = {} ]
       annotationAssignment_ll1[ $art ]*
       (
         '{' { $art.elements = this.createDict(); }
-        elementDefOrExtend[ $art, true ]*
+        elementDefOrExtend[ $art ]*
         '}' { this.finalizeDictOrArray( $art.elements ); }
         { this.checkExtensionDict( $art.elements ); }
         optionalSemi
@@ -965,13 +962,13 @@ extendWithOptElementsOrType[ art ]
     annotationAssignment_ll1[ $art ]*
     (
       '{' { $art.elements = this.createDict(); }
-      elementDefOrExtend[ $art, true ]*
+      elementDefOrExtend[ $art ]*
       '}' { this.finalizeDictOrArray( $art.elements ); }
       { this.checkExtensionDict( $art.elements ); }
       optionalSemi
     |
       ELEMENTS { $art.elements = this.createDict(); } '{'
-      elementDefOrExtend[ $art ]*
+      elementDefOrExtend[ $art, true ]*
       '}' { this.finalizeDictOrArray( $art.elements ); }
       { this.checkExtensionDict( $art.elements ); }
       optionalSemi
@@ -995,7 +992,7 @@ extendWithOptElementsNoWith[ art ]
     annotationAssignment_ll1[ $art ]*
     (
       '{' { $art.elements = this.createDict(); }
-      elementDefOrExtend[ $art, true ]*
+      elementDefOrExtend[ $art ]*
       '}' { this.finalizeDictOrArray( $art.elements ); }
       { this.checkExtensionDict( $art.elements ); }
       optionalSemi
@@ -1006,7 +1003,7 @@ extendWithOptElementsNoWith[ art ]
 
 // For `extend … with elements` or `extend entity … with`, `extend aspect … with`,
 // i.e. definitions in { … } are never enums
-elementDefOrExtend[ outer, mightBeEnum = false ] locals[ art = {} ]
+elementDefOrExtend[ outer, explicitElement = false ] locals[ art = new parser.XsnArtifact() ]
 @after { /* #ATN 1 */ }  // if ($art) this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -1016,7 +1013,7 @@ elementDefOrExtend[ outer, mightBeEnum = false ] locals[ art = {} ]
       EXTEND
       extendElement[ $art, $outer ]
     |
-      elementDefInner[ $art, $outer, $mightBeEnum ]
+      elementDefInner[ $art, $outer, $explicitElement ]
     )
   ;
 
@@ -1030,7 +1027,7 @@ extendElement[ art, outer ]
     extendWithOptElementsOrType[ $art, $art ]
   ;
 
-annotateArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
+annotateArtifact[ art, outer ] locals[ name = new parser.XsnName(), elemName = new parser.XsnName() ]
 @after { this.attachLocation( $art ); }
   :
     simplePath[ $name, 'Annotate' ]
@@ -1090,7 +1087,7 @@ annotateArtifact[ art, outer ] locals[ name = {}, elemName = {} ]
     )
   ;
 
-annotateElement[ outer ] locals[ art = {} ]
+annotateElement[ outer ] locals[ art = new parser.XsnArtifact() ]
 @after{ this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -1110,7 +1107,7 @@ annotateElement[ outer ] locals[ art = {} ]
     )
   ;
 
-annotateAction [ outer ] locals [ art = {} ]
+annotateAction [ outer ] locals [ art = new parser.XsnArtifact() ]
 @after{ this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -1138,7 +1135,7 @@ annotateAction [ outer ] locals [ art = {} ]
 annotateReturns[ art ]
 @after{ this.attachLocation( $art.returns ); }
   :
-    ret=RETURNS { $art.returns = { kind: 'annotate' }; }
+    ret=RETURNS { $art.returns = new this.XsnArtifact();; $art.returns.kind = 'annotate'; }
     { this.docComment( $art.returns ); }
     annotationAssignment_ll1[ $art.returns ]*
     ( '{' { $art.returns.elements = this.createDict(); }
@@ -1150,7 +1147,7 @@ annotateReturns[ art ]
     )
   ;
 
-annotateParam [ outer ] locals [ art = {} ]
+annotateParam [ outer ] locals [ art = new parser.XsnArtifact() ]
 @after{ this.attachLocation( $art ); }
   :
     { $art.location = this.startLocation();; this.docComment( $art ); }
@@ -1424,9 +1421,12 @@ typeAssociationCont[ art ]
         )*
       )?
       '}' { this.finalizeDictOrArray( $art.foreignKeys ); }
+      defaultAndNullability[ $art ]?
     |
       ON cond=condition
       { $art.on=$cond.cond; }
+    |
+      defaultAndNullability[ $art ]
     )
   ;
 
@@ -1442,12 +1442,12 @@ typeAssociationElementCont[ art ] // including Composition
         )*
       )?
       '}' { this.finalizeDictOrArray( $art.foreignKeys ); }
-      nullability[ $art ]?
+      defaultAndNullability[ $art ]?
     |
       ON cond=condition
       { $art.on=$cond.cond; }
     |
-      nullability[ $art ]
+      defaultAndNullability[ $art ]
     )?
     { this.docComment( $art ); }
     annotationAssignment_ll1[ $art ]*
@@ -1515,7 +1515,7 @@ nullability[ art ]
   | n1=NULL
   ;
 
-foreignKey[ outer ] locals[ art = {}, elem = {} ]
+foreignKey[ outer ] locals[ art = new parser.XsnArtifact(), elem = {} ]
 @after { this.attachLocation($art); }
   :
     simplePath[ $elem, 'ref' ] { $art.targetElement = $elem; }
@@ -1784,7 +1784,7 @@ tableTerm returns [ table ]
       }
       ':' fromPath[ $table, 'ref']
     )?
-    ( AS n1=ident['FromAlias'] { $table.name = $n1.id }
+    ( AS n1=ident['FromAlias'] { $table.name = $n1.id; }
     | n2=identNoKeyword['FromAlias'] { $table.name = this.fragileAlias( $n2.id ); }
       // if we would use rule `ident`, we would either had to make all JOIN
       // kinds reserved or introduce ATN
@@ -1823,7 +1823,7 @@ fromPath[ qp, idkind ] returns[ dotAfterFilter = null ]
         if (!$qp.scope) $qp.scope = $qp.path.length;
       } }
       '.' id=ident[$idkind] { this.pushIdent( $qp.path, $id.id ); }
-      ( fromArguments[ $id.id ] cardinalityAndFilter[ $id.id ]? 
+      ( fromArguments[ $id.id ] cardinalityAndFilter[ $id.id ]?
         { if (!$dotAfterFilter) $dotAfterFilter = false; }
       | cardinalityAndFilter[ $id.id ]
         { if (!$dotAfterFilter) $dotAfterFilter = false; }
@@ -1887,7 +1887,7 @@ selectItemDef[ outer ] locals[ art ]
     star='*'
     { $outer.push( this.valueWithTokenLocation( '*', $star ) ); }
   |
-    { $art = {};; this.docComment( $art ); }
+    { $art = new this.XsnArtifact();; this.docComment( $art ); }
     annotationAssignment_atn[ $art ]*
     // VIRTUAL is keyword, except if before the following tokens texts:
     { this.setLocalToken( 'VIRTUAL', 'VIRTUAL', /^([,.:\[@]|as)$/i ) ; } // not '{'
@@ -1904,7 +1904,7 @@ selectItemDefBody[ art, outer ] locals[ assoc ]
       e=expression { $art.value = $e.expr; }
       // we cannot use 'condition' instead, as long as we allow aliases without
       // AS (using rule 'ident' instead of 'identNoKeyword') -> ambiguities
-      ( as=AS n1=ident['Item'] { $art.name = $n1.id }
+      ( as=AS n1=ident['Item'] { $art.name = $n1.id; }
       | n2=ident['Item'] { $art.name = this.fragileAlias( $n2.id, true ); }
       | { this.classifyImplicitName( 'Item', $e.expr ); }
       )
@@ -1929,7 +1929,7 @@ selectItemDefBody[ art, outer ] locals[ assoc ]
     |
       selectItemInlineList[ $art, 'expand' ]
       excludingClause[ $art ]?
-      AS n1=ident['Item'] { $art.name = $n1.id }
+      AS n1=ident['Item'] { $art.name = $n1.id; }
     )
     { this.docComment( $art ); }
     annotationAssignment_fix[ $art ]*
@@ -1995,7 +1995,7 @@ selectItemInlineDef[ outer ] locals[ art ]
     star='*'
     { $outer.push( this.valueWithTokenLocation( '*', $star ) ); }
   |
-    { $art = {};; this.docComment( $art ); }
+    { $art = new this.XsnArtifact();; this.docComment( $art ); }
     annotationAssignment_atn[ $art ]*
     selectItemDefBody[ $art, $outer ]
   ;
@@ -2010,11 +2010,8 @@ orderByClause[ inQuery ] returns [ query ]
 limitClause[ inQuery ] returns [ query ]
   :
     limkw=LIMIT { $query = this.unaryOpForParens( $inQuery, '$'+'query' ); }
-    ( lim=Number   { $query.limit = { rows: this.numberLiteral( $lim, '' ) }; }
-    | limnull=NULL { $query.limit = { rows: {
-        literal: 'null', val: null, location: this.tokenLocation($limnull) } }; }
-    )
-    ( OFFSET off=Number { $query.limit.offset = this.numberLiteral( $off ); } )? // unsigned integer
+    lim=expression  { $query.limit = { rows: $lim.expr }; }
+    ( OFFSET off=expression { $query.limit.offset = $off.expr; } )? // unsigned integer
   ;
 
 orderBySpec returns[ ob ]
@@ -2312,7 +2309,7 @@ expressionTerm returns [ expr ] locals [ args = [] ]
     )
   ;
 
-specialFunction returns [ ret = {} ] locals[ art = {} ]
+specialFunction returns [ ret = {} ] locals[ art = new parser.XsnArtifact() ]
   :
     ca=CAST '('                 // see createArray() in action
     {
@@ -2663,7 +2660,7 @@ annotationAssignment_fix[ art ] locals[ assignment ]
     (
       annotationAssignment_paren[ $art ]
     |
-      { $assignment = { name: {} }; }
+      { $assignment = { name: new this.XsnName() }; }
       annotationPath[ $assignment.name, 'anno' ]
       ( '#' annotationPathVariant[ $assignment.name ] )?
       { this.warnIfColonFollows( $assignment ); }
@@ -2681,7 +2678,7 @@ annotationAssignment_ll1[ art ] locals[ assignment ]
     (
       annotationAssignment_paren[ $art ]
     |
-      { $assignment = { name: {} }; }
+      { $assignment = { name: new this.XsnName() }; }
       annotationPath[ $assignment.name, 'anno' ]
       ( '#' annotationPathVariant[ $assignment.name ] )?
       (
@@ -2703,7 +2700,7 @@ annotationAssignment_atn[ art ] locals[ assignment ]
     (
       annotationAssignment_paren[ $art ]
     |
-      { $assignment = { name: {} }; }
+      { $assignment = { name: new this.XsnName() }; }
       annotationPath[ $assignment.name, 'anno' ]
       // '#' is in the follow set of this rule, as it is used in rule "selectItemDef"
       // before an "expression" which can start with a '#' for an enum value
@@ -2749,7 +2746,7 @@ annotationAssignment_paren[ art ]
     ')'
   ;
 
-annotationAssignment_1[ art ] locals[ assignment = { name: {} } ]
+annotationAssignment_1[ art ] locals[ assignment = { name: new parser.XsnName() } ]
 @after { this.assignAnnotation( $art, $assignment ); }
   :
     annotationPath[ $assignment.name, 'anno' ]
@@ -2865,7 +2862,7 @@ annoValueBase[ assignment ] locals [ seenEllipsis = false ]
     ')'
   ;
 
-flattenedValue[ assignment ] locals[ val = { name: {} } ]
+flattenedValue[ assignment ] locals[ val = { name: new parser.XsnName() } ]
   :
     at='@'? annotationPath[ $val.name, 'name', $at ]
     ( '#' annotationPathVariant[ $val.name ] )?
@@ -2876,7 +2873,7 @@ flattenedValue[ assignment ] locals[ val = { name: {} } ]
     { $assignment['$'+'flatten'].push( $val ); }
   ;
 
-namedValue[ struct ] locals[ val = { name: {} } ]
+namedValue[ struct ] locals[ val = { name: new parser.XsnName() } ]
   :
     at='@'? annotationPath[ $val.name, 'name', $at ]
     ( ':' { this.meltKeywordToIdentifier(true); }

package/lib/language/multiLineStringParser.js

@@ -6,6 +6,7 @@ const {
   cdlNewLineRegEx,
 } = require('./textUtils');
 const { CompilerAssertion } = require('../base/error');
+const { CsnLocation } = require('../compiler/classes');
 
 /**
  * Strips and counts the indentation from the given string.
@@ -462,6 +463,7 @@ class MultiLineStringParser {
    */
   _locationForCharacters(i, width) {
     return {
+      __proto__: CsnLocation.prototype,
       file: this.parser.filename,
       line: this.token.line + this._lineInString,
       endLine: this.token.line + this._lineInString,

package/lib/main.d.ts

@@ -70,6 +70,18 @@ declare namespace compiler {
      *  - universal : In development (BETA)
      */
     csnFlavor?: string | 'client' | 'gensrc' | 'universal'
+    /**
+     * If set, backends will not create localized convenience views for those views,
+     * that only have an association to a localized entity/view.  Views will only get
+     * a convenience view, if they themselves contain localized elements (i.e. either
+     * have simple projection on localized elements and CDL-casts to a localized element).
+     *
+     * The OData backend will not set `$localized: true` markers for such cases.
+     *
+     * Does not work for backends to.hdi(), to.hdbcds() or to.sql() with `sqlDialect: 'hana'`,
+     * since in all those dialects, associations still exist in generated artifacts.
+     */
+    fewerLocalizedViews?: boolean
   }
 
   /**
@@ -86,6 +98,30 @@ declare namespace compiler {
      * the prefix for SAP CDS packages / CDS files.
      */
     cdsHome?: string
+    /**
+     * "Doc comments" (documentation comments) are those comments starting with `/**` in CDL
+     * or the `doc` property in CSN.  This option is an _output_ option, which can have three
+     * values:
+     *
+     *  - `true`:
+     *     Doc comments will appear in the compiled CSN.  Basic sanity checks are performed:
+     *     In CDL, if a doc comment appears at a not-defined position, where it has no impact,
+     *     an info message is emitted.  For CSN input, it is checked that the `doc` property
+     *     is a string or `null`.
+     *
+     *  - `false`:
+     *    Doc comments will not be parsed for CDL, and will be stripped from input CSN,
+     *    i.e. the compiled CSN (output) does not contain `doc` properties.  No checks
+     *    are performed on doc comments.
+     *
+     *  - `undefined`:
+     *    Doc comments are checked (see value `true`). For CDL, doc comments are not parsed,
+     *    i.e. will not appear in the compiled CSN (output).
+     *    For CSN input, all `doc` properties remain in the CSN.
+     *
+     * The CDL equivalent of the CSN value `doc: null`, is an empty doc comment.
+     */
+    docComment?: boolean
     /**
      * When set to `true`, and the model contains an entity `sap.common.Languages`
      * with an element `code`, all generated texts entities additionally contain
@@ -95,6 +131,17 @@ declare namespace compiler {
      * @since v2.8.0
      */
     addTextsLanguageAssoc?: boolean
+    /**
+     * An array of directory names that are used for CDS module lookups.
+     * Lookup directory `node_modules/` is appended if not set explicitly.
+     *
+     * All directories in this array follow the same lookup-pattern as `node_modules/`.
+     *
+     * See <https://cap.cloud.sap/docs/cds/cdl#model-resolution>
+     *
+     * @since v4.2.0
+     */
+    moduleLookupDirectories?: string[]
     /**
      * Option for {@link compileSources}.  If set, all objects inside the
      * provided sources dictionary are interpreted as XSN structures instead
@@ -466,6 +513,12 @@ declare namespace compiler {
    */
   export class CompilationError extends Error {
       constructor(messages: CompileMessage[], model?: any, text?: string, ...args: any[]);
+      /**
+       * String to identify this class. Can be used instead of relying on `instanceof`.
+       * Always `ERR_CDS_COMPILATION_FAILURE`.
+       * @since v4.0.0
+       */
+      code: string;
       messages: CompileMessage[];
       toString(): string;
       /**
@@ -798,6 +851,9 @@ declare namespace compiler {
        * identifier in brackets.
        * Otherwise, return the name without brackets.
        *
+       * NOTE: If `name` contains newline characters, the resulting delimited identifier
+       *       will not be parsable by the compiler!
+       *
        * Example:
        *    ```js
        *    to.cdl.smartId('with ![brackets]')
@@ -812,6 +868,9 @@ declare namespace compiler {
        *
        * @param name
        * @param [insideFunction=null]
+       *     Inside special functions such as SAP HANA's `OCCURRENCES_REGEXPR`, there are more
+       *     keywords than in other places.  Set this value to a function name, if you want to
+       *     handle those additional keywords as well.
        */
       function smartId(name: string, insideFunction?: string|null) : string;
       /**
@@ -819,6 +878,9 @@ declare namespace compiler {
        * function identifier in brackets for CDL.
        * Otherwise, return the function name without brackets.
        *
+       * NOTE: If `name` contains newline characters, the resulting delimited identifier
+       *       will not be parsable by the compiler!
+       *
        * Example:
        *    ```js
        *    to.cdl.smartFunctionId('with ![brackets]')
@@ -834,6 +896,9 @@ declare namespace compiler {
        * Escapes the given name according to the CDL language and puts it
        * into `![` and `]`, properly escaping all `]` in the identifier.
        *
+       * NOTE: If `name` contains newline characters, the resulting delimited identifier
+       *       will not be parsable by the compiler!
+       *
        * Example:
        *    ```js
        *    to.cdl.delimitedId('with ![brackets]')