@abaplint/core 2.119.43 → 2.119.45

package/build/abaplint.d.ts

@@ -28,7 +28,7 @@ export declare abstract class ABAPObject extends AbstractObject {
     abstract getDescription(): string | undefined;
     constructor(name: string);
     static is(x: any): x is ABAPObject;
-    parse(version: Version, globalMacros?: readonly string[], reg?: IRegistry): IParseResult;
+    parse(release: ABAPRelease, globalMacros?: readonly string[], reg?: IRegistry, languageVersion?: LanguageVersion, openABAP?: boolean): IParseResult;
     setDirty(): void;
     private getParsedXML;
     getABAPFiles(): readonly ABAPFile[];
@@ -59,6 +59,27 @@ declare class ABAPQueryQuery extends AbstractObject {
     getDescription(): string | undefined;
 }
 
+/**
+ * A single row in the release table.
+ *
+ * abap   — SAP_BASIS / ABAP release name as SAP calls it (e.g. "740SP05", "7.90", "9.16")
+ * kernel — SAP kernel release number that ships this ABAP release
+ * op     — on-premise release number (e.g. 758, 816), null for cloud-only releases
+ * cloud  — cloud release number (e.g. 793, 916), null for pre-cloud releases
+ * ce     — SAP BTP / S/4HANA Cloud Public Edition shipment quarter (YYMM, e.g. 2308),
+ *           null if never shipped to customers on cloud
+ * ordinal — chronological index (set at build time from array position), used for ordering
+ */
+export declare interface ABAPRelease {
+    readonly name: string;
+    readonly abap: string | null;
+    readonly kernel: number | null;
+    readonly op: number | null;
+    readonly cloud: number | null;
+    readonly ce: number | null;
+    readonly ordinal: number;
+}
+
 declare class Abstract extends Expression {
     getRunnable(): IStatementRunnable;
 }
@@ -101,7 +122,7 @@ declare abstract class AbstractObject implements IObject {
     abstract getDescription(): string | undefined;
     constructor(name: string);
     getParsingIssues(): readonly Issue[];
-    parse(_version?: Version, _globalMacros?: readonly string[], _reg?: IRegistry): IParseResult;
+    parse(_release?: ABAPRelease, _globalMacros?: readonly string[], _reg?: IRegistry, _languageVersion?: LanguageVersion, _openABAP?: boolean): IParseResult;
     getName(): string;
     setDirty(): void;
     addFile(file: IFile): void;
@@ -1442,7 +1463,7 @@ declare class CondSub extends Expression {
 
 export declare class Config implements IConfiguration {
     private readonly config;
-    static getDefault(ver?: Version): Config;
+    static getDefault(ver?: VersionOldOrNew, langVer?: LanguageVersion, openABAP?: boolean): Config;
     getEnabledRules(): IRule[];
     constructor(json: string);
     get(): IConfig;
@@ -1450,7 +1471,10 @@ export declare class Config implements IConfiguration {
     readByRule(rule: string): any;
     getGlobal(): IGlobalConfig;
     getSyntaxSetttings(): ISyntaxSettings;
+    getRelease(): ABAPRelease;
+    getOpenABAP(): boolean;
     getVersion(): Version;
+    getLanguageVersion(): LanguageVersion;
     private checkVersion;
 }
 
@@ -1547,7 +1571,10 @@ export declare class CurrentScope {
     static buildDefault(reg: IRegistry, obj: IObject): CurrentScope;
     private static addBuiltIn;
     private constructor();
+    getRelease(): ABAPRelease;
     getVersion(): Version;
+    getLanguageVersion(): LanguageVersion;
+    getOpenABAP(): boolean;
     getRegistry(): IRegistry;
     addType(type: TypedIdentifier | undefined): void;
     addTypeNamed(name: string, type: TypedIdentifier | undefined): void;
@@ -1672,6 +1699,8 @@ declare class DatabaseConnection extends Expression {
 }
 
 declare class DatabaseTable extends Expression {
+    private readonly noDynamic;
+    constructor(noDynamic?: boolean);
     getRunnable(): IStatementRunnable;
 }
 
@@ -2381,6 +2410,7 @@ declare abstract class Expression implements IStatementRunnable {
 declare class ExpressionNode extends AbstractNode<ExpressionNode | TokenNode> {
     private readonly expression;
     constructor(expression: IStatementRunnable);
+    addChild(_n: ExpressionNode | TokenNode): void;
     get(): IStatementRunnable;
     countTokens(): number;
     getFirstToken(): Token;
@@ -2594,7 +2624,20 @@ declare namespace Expressions {
         SQLFromSource,
         SQLFrom,
         SQLFunctionInput,
+        sqlFunctionDefs,
+        sqlNamedFunctionDefs,
+        sqlSpatialFunctionDefs,
+        sqlSpatialAggregateDefs,
         SQLFunction,
+        SQLRegexprPattern,
+        SQLRegexprFrom,
+        SQLRegexprOccurrence,
+        SQLRegexprGroup,
+        SQLReplaceRegexpr,
+        SQLOccurrencesRegexpr,
+        SQLSubstringRegexpr,
+        SQLLocateRegexpr,
+        SQLLikeRegexpr,
         SQLGroupBy,
         SQLHaving,
         SQLHints,
@@ -3316,7 +3359,7 @@ declare interface IBuiltinMethod {
     optional?: {
         [key: string]: AbstractType;
     };
-    version?: Version;
+    release?: ABAPRelease;
     predicate?: boolean;
     return: AbstractType;
     cache?: BuiltInMethod | undefined;
@@ -3380,7 +3423,11 @@ export declare interface IConfiguration {
     getEnabledRules(): IRule[];
     get(): IConfig;
     getGlobal(): IGlobalConfig;
+    /** @deprecated Use getRelease() instead. */
     getVersion(): Version;
+    getRelease(): ABAPRelease;
+    getLanguageVersion(): LanguageVersion;
+    getOpenABAP(): boolean;
     getSyntaxSetttings(): ISyntaxSettings;
     readByRule(rule: string): any;
     readByKey(rule: string, key: string): any;
@@ -4013,7 +4060,7 @@ export declare interface IObject extends IArtifact {
     /** returns true if the object was parsed, false if no changes since last parse
      * registry for global cross object macros
      */
-    parse(version?: Version, globalMacros?: readonly string[], reg?: IRegistry): IParseResult;
+    parse(release?: ABAPRelease, globalMacros?: readonly string[], reg?: IRegistry, languageVersion?: LanguageVersion, openABAP?: boolean): IParseResult;
     getParsingIssues(): readonly Issue[];
     getFiles(): readonly IFile[];
     addFile(file: IFile): void;
@@ -4306,7 +4353,10 @@ declare interface ISyntaxResult {
 
 declare interface ISyntaxSettings {
     /** ABAP language version */
-    version?: Version;
+    version?: VersionOldOrNew;
+    languageVersion?: LanguageVersion;
+    /** Use the OpenABAP dialect (v702 base + a set of additional language features). */
+    openABAP?: boolean;
     /** Report error for objects in this regex namespace. Types not in namespace will be void. Case insensitive */
     errorNamespace: string;
     /** List of full named global constants (regex not possible)
@@ -4424,6 +4474,21 @@ declare namespace LanguageServerTypes {
 }
 export { LanguageServerTypes }
 
+/**
+ * Dialect / flavor axis, orthogonal to the on-prem/cloud release track.
+ *
+ * `Normal`  = full ABAP, no restrictions.
+ * `Cloud`   = restricted ABAP for Cloud, syntactic and semantic restrictions apply.
+ * `KeyUser` = stricter still (KeyUser Extensibility), strict subset of Cloud.
+ *
+ * Ordering: KeyUser(0) &lt; Cloud(1) &lt; Normal(2) — lower = more restrictive.
+ */
+export declare enum LanguageVersion {
+    Normal = "Normal",
+    KeyUser = "KeyUser",
+    Cloud = "Cloud"
+}
+
 declare class Leave implements IStatement {
     getMatcher(): IStatementRunnable;
 }
@@ -5676,7 +5741,7 @@ declare class ProxyObject extends AbstractObject {
     };
     getDescription(): string | undefined;
     setDirty(): void;
-    parse(_version?: Version, _globalMacros?: readonly string[], reg?: IRegistry): {
+    parse(_release?: ABAPRelease, _globalMacros?: readonly string[], reg?: IRegistry): {
         updated: boolean;
         runtime: number;
     };
@@ -5875,6 +5940,365 @@ declare class Reject implements IStatement {
     getMatcher(): IStatementRunnable;
 }
 
+/** Lookup table keyed by release name (e.g. `Release.v740sp05`, `Release.Newest`). */
+export declare const Release: {
+    readonly [name: string]: ABAPRelease;
+};
+
+/**
+ * Is `running` at least as new as `required`?
+ * Comparison is purely by ordinal (declaration order in ReleaseList).
+ * Newest (last entry) satisfies any required release.
+ */
+export declare function releaseAtLeast(running: ABAPRelease, required: ABAPRelease): boolean;
+
+declare const releaseDefsRaw: readonly [readonly ["v700", {
+    readonly abap: "700";
+    readonly kernel: 700;
+    readonly op: 700;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v701", {
+    readonly abap: "701";
+    readonly kernel: 701;
+    readonly op: 701;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v702", {
+    readonly abap: "702";
+    readonly kernel: 702;
+    readonly op: 702;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v710", {
+    readonly abap: "710";
+    readonly kernel: 710;
+    readonly op: 710;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v711", {
+    readonly abap: "711";
+    readonly kernel: 711;
+    readonly op: 711;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v720", {
+    readonly abap: "720";
+    readonly kernel: 720;
+    readonly op: 720;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v722", {
+    readonly abap: "722";
+    readonly kernel: 722;
+    readonly op: 722;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v730", {
+    readonly abap: "730";
+    readonly kernel: 730;
+    readonly op: 730;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v731", {
+    readonly abap: "731";
+    readonly kernel: 731;
+    readonly op: 731;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v740sp02", {
+    readonly abap: "740SP02";
+    readonly kernel: 740;
+    readonly op: 740;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v740sp05", {
+    readonly abap: "740SP05";
+    readonly kernel: 741;
+    readonly op: 740;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v740sp08", {
+    readonly abap: "740SP08";
+    readonly kernel: 742;
+    readonly op: 740;
+    readonly cloud: null;
+    readonly ce: null;
+}], readonly ["v760", {
+    readonly abap: "7.60";
+    readonly kernel: 743;
+    readonly op: 750;
+    readonly cloud: 760;
+    readonly ce: null;
+}], readonly ["v761", {
+    readonly abap: "7.61";
+    readonly kernel: 744;
+    readonly op: 750;
+    readonly cloud: 761;
+    readonly ce: null;
+}], readonly ["v762", {
+    readonly abap: "7.62";
+    readonly kernel: 745;
+    readonly op: 750;
+    readonly cloud: 762;
+    readonly ce: null;
+}], readonly ["v763", {
+    readonly abap: "7.63";
+    readonly kernel: 746;
+    readonly op: 751;
+    readonly cloud: 763;
+    readonly ce: null;
+}], readonly ["v764", {
+    readonly abap: "7.64";
+    readonly kernel: 747;
+    readonly op: 751;
+    readonly cloud: 764;
+    readonly ce: null;
+}], readonly ["v765", {
+    readonly abap: "7.65";
+    readonly kernel: 748;
+    readonly op: 751;
+    readonly cloud: 765;
+    readonly ce: null;
+}], readonly ["v766", {
+    readonly abap: "7.66";
+    readonly kernel: 749;
+    readonly op: 752;
+    readonly cloud: 766;
+    readonly ce: null;
+}], readonly ["v767", {
+    readonly abap: "7.67";
+    readonly kernel: 750;
+    readonly op: 752;
+    readonly cloud: 767;
+    readonly ce: 1702;
+}], readonly ["v768", {
+    readonly abap: "7.68";
+    readonly kernel: 751;
+    readonly op: 752;
+    readonly cloud: 768;
+    readonly ce: 1705;
+}], readonly ["v769", {
+    readonly abap: "7.69";
+    readonly kernel: 752;
+    readonly op: 752;
+    readonly cloud: 769;
+    readonly ce: 1708;
+}], readonly ["v770", {
+    readonly abap: "7.70";
+    readonly kernel: 753;
+    readonly op: 753;
+    readonly cloud: 770;
+    readonly ce: 1711;
+}], readonly ["v771", {
+    readonly abap: "7.71";
+    readonly kernel: 771;
+    readonly op: 753;
+    readonly cloud: 771;
+    readonly ce: 1802;
+}], readonly ["v772", {
+    readonly abap: "7.72";
+    readonly kernel: 772;
+    readonly op: 753;
+    readonly cloud: 772;
+    readonly ce: 1805;
+}], readonly ["v773", {
+    readonly abap: "7.73";
+    readonly kernel: 773;
+    readonly op: 753;
+    readonly cloud: 773;
+    readonly ce: 1808;
+}], readonly ["v774", {
+    readonly abap: "7.74";
+    readonly kernel: 774;
+    readonly op: 754;
+    readonly cloud: 774;
+    readonly ce: 1811;
+}], readonly ["v775", {
+    readonly abap: "7.75";
+    readonly kernel: 775;
+    readonly op: 754;
+    readonly cloud: 775;
+    readonly ce: 1902;
+}], readonly ["v776", {
+    readonly abap: "7.76";
+    readonly kernel: 776;
+    readonly op: 754;
+    readonly cloud: 776;
+    readonly ce: 1905;
+}], readonly ["v777", {
+    readonly abap: "7.77";
+    readonly kernel: 777;
+    readonly op: 754;
+    readonly cloud: 777;
+    readonly ce: 1908;
+}], readonly ["v778", {
+    readonly abap: "7.78";
+    readonly kernel: 778;
+    readonly op: 755;
+    readonly cloud: 778;
+    readonly ce: 1911;
+}], readonly ["v779", {
+    readonly abap: "7.79";
+    readonly kernel: 779;
+    readonly op: 755;
+    readonly cloud: 779;
+    readonly ce: 2002;
+}], readonly ["v780", {
+    readonly abap: "7.80";
+    readonly kernel: 780;
+    readonly op: 755;
+    readonly cloud: 780;
+    readonly ce: 2005;
+}], readonly ["v781", {
+    readonly abap: "7.81";
+    readonly kernel: 781;
+    readonly op: 755;
+    readonly cloud: 781;
+    readonly ce: 2008;
+}], readonly ["v782", {
+    readonly abap: "7.82";
+    readonly kernel: 782;
+    readonly op: 756;
+    readonly cloud: 782;
+    readonly ce: 2011;
+}], readonly ["v783", {
+    readonly abap: "7.83";
+    readonly kernel: 783;
+    readonly op: 756;
+    readonly cloud: 783;
+    readonly ce: 2102;
+}], readonly ["v784", {
+    readonly abap: "7.84";
+    readonly kernel: 784;
+    readonly op: 756;
+    readonly cloud: 784;
+    readonly ce: 2105;
+}], readonly ["v785", {
+    readonly abap: "7.85";
+    readonly kernel: 785;
+    readonly op: 756;
+    readonly cloud: 785;
+    readonly ce: 2108;
+}], readonly ["v786", {
+    readonly abap: "7.86";
+    readonly kernel: 786;
+    readonly op: 757;
+    readonly cloud: 786;
+    readonly ce: 2111;
+}], readonly ["v787", {
+    readonly abap: "7.87";
+    readonly kernel: 787;
+    readonly op: 757;
+    readonly cloud: 787;
+    readonly ce: 2202;
+}], readonly ["v788", {
+    readonly abap: "7.88";
+    readonly kernel: 788;
+    readonly op: 757;
+    readonly cloud: 788;
+    readonly ce: 2205;
+}], readonly ["v789", {
+    readonly abap: "7.89";
+    readonly kernel: 789;
+    readonly op: 757;
+    readonly cloud: 789;
+    readonly ce: 2208;
+}], readonly ["v790", {
+    readonly abap: "7.90";
+    readonly kernel: 790;
+    readonly op: 758;
+    readonly cloud: 790;
+    readonly ce: 2211;
+}], readonly ["v791", {
+    readonly abap: "7.91";
+    readonly kernel: 791;
+    readonly op: 758;
+    readonly cloud: 791;
+    readonly ce: 2302;
+}], readonly ["v792", {
+    readonly abap: "7.92";
+    readonly kernel: 792;
+    readonly op: 758;
+    readonly cloud: 792;
+    readonly ce: 2305;
+}], readonly ["v793", {
+    readonly abap: "7.93";
+    readonly kernel: 793;
+    readonly op: 758;
+    readonly cloud: 793;
+    readonly ce: 2308;
+}], readonly ["v794", {
+    readonly abap: "7.94";
+    readonly kernel: 794;
+    readonly op: 816;
+    readonly cloud: 794;
+    readonly ce: 2311;
+}], readonly ["v795", {
+    readonly abap: "7.95";
+    readonly kernel: 795;
+    readonly op: 816;
+    readonly cloud: 795;
+    readonly ce: 2402;
+}], readonly ["v796", {
+    readonly abap: "7.96";
+    readonly kernel: 796;
+    readonly op: 816;
+    readonly cloud: 796;
+    readonly ce: 2405;
+}], readonly ["v912", {
+    readonly abap: "9.12";
+    readonly kernel: 912;
+    readonly op: 816;
+    readonly cloud: 912;
+    readonly ce: 2408;
+}], readonly ["v913", {
+    readonly abap: "9.13";
+    readonly kernel: 913;
+    readonly op: 816;
+    readonly cloud: 913;
+    readonly ce: 2411;
+}], readonly ["v914", {
+    readonly abap: "9.14";
+    readonly kernel: 914;
+    readonly op: 816;
+    readonly cloud: 914;
+    readonly ce: 2502;
+}], readonly ["v915", {
+    readonly abap: "9.15";
+    readonly kernel: 915;
+    readonly op: 816;
+    readonly cloud: 915;
+    readonly ce: 2505;
+}], readonly ["v916", {
+    readonly abap: "9.16";
+    readonly kernel: 916;
+    readonly op: 816;
+    readonly cloud: 916;
+    readonly ce: 2508;
+}], readonly ["v917", {
+    readonly abap: "9.17";
+    readonly kernel: 917;
+    readonly op: null;
+    readonly cloud: 917;
+    readonly ce: 2511;
+}], readonly ["v918", {
+    readonly abap: "9.18";
+    readonly kernel: 918;
+    readonly op: null;
+    readonly cloud: 918;
+    readonly ce: 2602;
+}], readonly ["Newest", {
+    readonly abap: null;
+    readonly kernel: null;
+    readonly op: null;
+    readonly cloud: null;
+    readonly ce: null;
+}]];
+
+/** Union of all raw release name strings, e.g. `"v700" | "v758" | "Newest"`. */
+declare type ReleaseName = (typeof releaseDefsRaw)[number][0];
+
 export declare class Rename {
     private readonly reg;
     constructor(reg: IRegistry);
@@ -5934,6 +6358,8 @@ declare class Result {
     popNode(): ExpressionNode | TokenNode | undefined;
     getNodes(): (ExpressionNode | TokenNode)[];
     setNodes(n: (ExpressionNode | TokenNode)[]): void;
+    getTokens(): readonly Token[];
+    getTokenIndex(): number;
     remainingLength(): number;
 }
 
@@ -6490,6 +6916,10 @@ declare class SQLFunction extends Expression {
     getRunnable(): IStatementRunnable;
 }
 
+declare type SQLFunctionDef = [string, number, ABAPRelease];
+
+declare const sqlFunctionDefs: SQLFunctionDef[];
+
 declare class SQLFunctionInput extends Expression {
     getRunnable(): IStatementRunnable;
 }
@@ -6542,6 +6972,30 @@ declare class SQLJoinSource extends Expression {
     getRunnable(): IStatementRunnable;
 }
 
+declare class SQLLikeRegexpr extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare class SQLLocateRegexpr extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare type SQLNamedFunctionDef = [string, ABAPRelease, SQLNamedParam[]];
+
+declare const sqlNamedFunctionDefs: SQLNamedFunctionDef[];
+
+declare type SQLNamedParam = {
+    name: string;
+    value: SQLNamedParamValue;
+    optional?: true;
+};
+
+declare type SQLNamedParamValue = "any" | "abap_only";
+
+declare class SQLOccurrencesRegexpr extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
 declare class SQLOptions extends Expression {
     getRunnable(): IStatementRunnable;
 }
@@ -6584,6 +7038,26 @@ declare class SQLPrivilegedAccess extends Expression {
     getRunnable(): IStatementRunnable;
 }
 
+declare class SQLRegexprFrom extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare class SQLRegexprGroup extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare class SQLRegexprOccurrence extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare class SQLRegexprPattern extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
+declare class SQLReplaceRegexpr extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
 declare class SQLSetOp extends Expression {
     getRunnable(): IStatementRunnable;
 }
@@ -6604,6 +7078,14 @@ declare class SQLSourceSimple extends Expression {
     getRunnable(): IStatementRunnable;
 }
 
+declare const sqlSpatialAggregateDefs: SQLFunctionDef[];
+
+declare const sqlSpatialFunctionDefs: SQLFunctionDef[];
+
+declare class SQLSubstringRegexpr extends Expression {
+    getRunnable(): IStatementRunnable;
+}
+
 declare class SQLTarget extends Expression {
     getRunnable(): IStatementRunnable;
 }
@@ -7754,6 +8236,7 @@ declare class VerificationMessage implements IStatement {
     getMatcher(): IStatementRunnable;
 }
 
+/** @deprecated Use ABAPRelease and Release instead */
 export declare enum Version {
     OpenABAP = "open-abap",// as 702, but with some extra new language features
     v700 = "v700",
@@ -7770,9 +8253,25 @@ export declare enum Version {
     v756 = "v756",
     v757 = "v757",
     v758 = "v758",
+    v816 = "v816",
+    /**
+     * Steampunk / SAP BTP ABAP Environment. This was never a release identity —
+     * it always meant "latest available release, parsed under cloud-language
+     * restrictions". It expands into the explicit
+     * Release.Newest + {@link LanguageVersion.Cloud} pair.
+     */
     Cloud = "Cloud"
 }
 
+declare type VersionNew = {
+    release: ReleaseName;
+    language: LanguageVersion;
+};
+
+declare type VersionOldOrNew = Version | VersionNew;
+
+export declare function versionToABAPRelease(v: Version): ABAPRelease;
+
 declare class View extends AbstractObject {
     private parsedData;
     getType(): string;