@elastic/esql 0.0.1

package/lib/embedded_languages/promql/parser/cst_to_ast_converter.d.ts

@@ -0,0 +1,48 @@
+import * as cst from '../../../parser/antlr/promql_parser';
+import type * as ast from '../types';
+import type { PromQLParser } from './parser';
+/**
+ * Transforms an ANTLR PromQL Concrete Syntax Tree (CST) into a
+ * Kibana Abstract Syntax Tree (AST).
+ */
+export declare class PromQLCstToAstConverter {
+    protected readonly parser: PromQLParser;
+    /**
+     * Character offset to add to all location values.
+     */
+    private readonly offset;
+    constructor(parser: PromQLParser);
+    private getParserFields;
+    private createParserFieldsFromToken;
+    private fromParserRuleToUnknown;
+    fromSingleStatement(ctx: cst.SingleStatementContext): ast.PromQLAstQueryExpression | undefined;
+    fromExpression(ctx: cst.ExpressionContext): ast.PromQLAstExpression | undefined;
+    private fromArithmeticUnary;
+    private fromValueExpression;
+    private fromValue;
+    private fromFunction;
+    private fromGrouping;
+    private fromLabelList;
+    private fromSelector;
+    private fromSeriesMatcher;
+    private fromLabels;
+    private fromLabel;
+    private fromLabelName;
+    private fromArithmeticBinary;
+    private toBinaryOperator;
+    private fromModifier;
+    private fromParenthesized;
+    private fromSubquery;
+    private fromEvaluation;
+    private fromOffset;
+    private fromAt;
+    private fromDuration;
+    private fromConstant;
+    private fromNumber;
+    private fromString;
+    private fromStringToken;
+    private unquoteString;
+    private fromTimeValue;
+    private fromIdentifier;
+}
+//# sourceMappingURL=cst_to_ast_converter.d.ts.map

package/lib/embedded_languages/promql/parser/cst_to_ast_converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cst_to_ast_converter.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/parser/cst_to_ast_converter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,GAAG,MAAM,qCAAqC,CAAC;AAI3D,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C;;;GAGG;AACH,qBAAa,uBAAuB;IAMtB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IALnD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAED,MAAM,EAAE,YAAY;IAMnD,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,uBAAuB;IAcxB,mBAAmB,CACxB,GAAG,EAAE,GAAG,CAAC,sBAAsB,GAC9B,GAAG,CAAC,wBAAwB,GAAG,SAAS;IAgBpC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,mBAAmB,GAAG,SAAS;IAkCtF,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,YAAY;IAyDpB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,oBAAoB;IAoD5B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,YAAY;IAwEpB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;CAiBvB"}

package/lib/embedded_languages/promql/parser/index.d.ts

@@ -0,0 +1,4 @@
+export { PromQLParser, type PromQLParseOptions } from './parser';
+export { PromQLErrorListener } from './promql_error_listener';
+export { PromQLCstToAstConverter } from './cst_to_ast_converter';
+//# sourceMappingURL=index.d.ts.map

package/lib/embedded_languages/promql/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/parser/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/embedded_languages/promql/parser/parser.d.ts

@@ -0,0 +1,65 @@
+import { CommonTokenStream, type CharStream } from 'antlr4';
+import { default as PromQLLexer } from '../../../parser/antlr/promql_lexer';
+import { default as PromQLParserGenerated } from '../../../parser/antlr/promql_parser';
+import { PromQLErrorListener } from './promql_error_listener';
+import type { PromQLAstQueryExpression, PromQLParseResult } from '../types';
+import type { EditorError } from '../../../types';
+export interface PromQLParseOptions {
+    /**
+     * Character offset where the PromQL query begins. This is useful when
+     * PromQL queries are embedded inside other queries (e.g., ES|QL).
+     * The offset will be added to all location values in the AST.
+     */
+    offset?: number;
+}
+/**
+ * Parser for PromQL queries.
+ *
+ * This parser transforms PromQL source text into an Abstract Syntax Tree (AST)
+ * that can be used for analysis, validation, and transformation.
+ */
+export declare class PromQLParser {
+    readonly src: string;
+    readonly options: PromQLParseOptions;
+    /**
+     * Create a new PromQL parser instance.
+     */
+    static readonly create: (src: string, options?: PromQLParseOptions) => PromQLParser;
+    /**
+     * Parse a complete PromQL query, generating an AST and a list of parsing errors.
+     *
+     * Make sure to check the returned `errors` list for any parsing issues.
+     *
+     * For example:
+     *
+     * ```typescript
+     * const result = PromQLParser.parse('rate(http_requests_total[5m])');
+     * ```
+     *
+     * @param src Source text to parse.
+     * @param options Parsing options.
+     */
+    static readonly parse: (src: string, options?: PromQLParseOptions) => PromQLParseResult;
+    /**
+     * Extract parsing errors from the source text without generating an AST.
+     *
+     * @param src Source text to parse for errors.
+     * @returns A list of parsing errors.
+     */
+    static readonly parseErrors: (src: string) => EditorError[];
+    readonly streams: CharStream;
+    readonly lexer: PromQLLexer;
+    readonly tokens: CommonTokenStream;
+    readonly parser: PromQLParserGenerated;
+    readonly errors: PromQLErrorListener;
+    constructor(src: string, options?: PromQLParseOptions);
+    /**
+     * Parse the source text and return the AST.
+     */
+    parse(): PromQLParseResult<PromQLAstQueryExpression>;
+    /**
+     * Parse the source text and return only the errors.
+     */
+    parseErrors(): EditorError[];
+}
+//# sourceMappingURL=parser.d.ts.map

package/lib/embedded_languages/promql/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/parser/parser.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;aA2CL,GAAG,EAAE,MAAM;aACX,OAAO,EAAE,kBAAkB;IA3C7C;;OAEG;IACH,gBAAuB,MAAM,GAAI,KAAK,MAAM,EAAE,UAAU,kBAAkB,kBAExE;IAEF;;;;;;;;;;;;;OAaG;IACH,gBAAuB,KAAK,GAAI,KAAK,MAAM,EAAE,UAAU,kBAAkB,KAAG,iBAAiB,CAE3F;IAEF;;;;;OAKG;IACH,gBAAuB,WAAW,GAAI,KAAK,MAAM,KAAG,WAAW,EAAE,CAE/D;IAEF,SAAgB,OAAO,EAAE,UAAU,CAAC;IACpC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,MAAM,EAAE,qBAAqB,CAAC;IAC9C,SAAgB,MAAM,sBAA6B;gBAGjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB;IAclD;;OAEG;IACI,KAAK,IAAI,iBAAiB,CAAC,wBAAwB,CAAC;IA2B3D;;OAEG;IACI,WAAW,IAAI,WAAW,EAAE;CAIpC"}

package/lib/embedded_languages/promql/parser/promql_error_listener.d.ts

@@ -0,0 +1,11 @@
+import * as antlr4 from 'antlr4';
+import type { EditorError } from '../../../types';
+/**
+ * Error listener for PromQL parsing that collects syntax errors.
+ */
+export declare class PromQLErrorListener extends antlr4.ErrorListener<unknown> {
+    protected errors: EditorError[];
+    syntaxError(_recognizer: antlr4.Recognizer<unknown>, offendingSymbol: unknown, line: number, column: number, message: string, _error: antlr4.RecognitionException | undefined): void;
+    getErrors(): EditorError[];
+}
+//# sourceMappingURL=promql_error_listener.d.ts.map

package/lib/embedded_languages/promql/parser/promql_error_listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promql_error_listener.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/parser/promql_error_listener.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;IACpE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAM;IAErC,WAAW,CACT,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EACvC,eAAe,EAAE,OAAO,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,oBAAoB,GAAG,SAAS,GAC9C,IAAI;IAkBP,SAAS,IAAI,WAAW,EAAE;CAG3B"}

package/lib/embedded_languages/promql/pretty_print/basic_pretty_printer.d.ts

@@ -0,0 +1,65 @@
+import type { PromQLAstExpression, PromQLAstQueryExpression, PromQLBinaryExpression, PromQLFunction, PromQLGrouping, PromQLGroupModifier, PromQLIdentifier, PromQLLabel, PromQLLabelMap, PromQLLabelName, PromQLLiteral, PromQLModifier, PromQLNumericLiteral, PromQLParens, PromQLSelector, PromQLStringLiteral, PromQLSubquery, PromQLTimeValue, PromQLUnaryExpression, PromQLEvaluation, PromQLOffset, PromQLAt } from '../types';
+export interface PromQLBasicPrettyPrinterOptions {
+    /**
+     * Whether to lowercase function and aggregation names.
+     * @default false (keeps original case)
+     */
+    lowercaseFunctions?: boolean;
+    /**
+     * Whether to lowercase keywords like `by`, `without`, `on`, `ignoring`, etc.
+     * @default false (keeps original case)
+     */
+    lowercaseKeywords?: boolean;
+    /**
+     * Whether to lowercase operators like `and`, `or`, `unless`.
+     * @default false (keeps original case)
+     */
+    lowercaseOperators?: boolean;
+}
+/**
+ * A basic pretty-printer for PromQL AST nodes that outputs a single-line
+ * string representation with minimal formatting (one space between nodes).
+ */
+export declare class PromQLBasicPrettyPrinter {
+    /**
+     * Print any PromQL AST node.
+     */
+    static readonly print: (node: PromQLAstQueryExpression | PromQLAstExpression, opts?: PromQLBasicPrettyPrinterOptions) => string;
+    /**
+     * Print a PromQL query expression.
+     */
+    static readonly query: (query: PromQLAstQueryExpression, opts?: PromQLBasicPrettyPrinterOptions) => string;
+    /**
+     * Print a PromQL expression.
+     */
+    static readonly expression: (expr: PromQLAstExpression, opts?: PromQLBasicPrettyPrinterOptions) => string;
+    protected readonly opts: Required<PromQLBasicPrettyPrinterOptions>;
+    constructor(opts?: PromQLBasicPrettyPrinterOptions);
+    print(node: PromQLAstQueryExpression | PromQLAstExpression): string;
+    printQuery(query: PromQLAstQueryExpression): string;
+    printExpression(expr: PromQLAstExpression | undefined): string;
+    protected printFunction(node: PromQLFunction): string;
+    protected printGrouping(node: PromQLGrouping): string;
+    protected printSelector(node: PromQLSelector): string;
+    protected printLabelMap(node: PromQLLabelMap): string;
+    protected printLabel(node: PromQLLabel): string;
+    protected printLabelName(node: PromQLLabelName): string;
+    protected printEvaluation(node: PromQLEvaluation): string;
+    protected printOffset(node: PromQLOffset): string;
+    protected printAt(node: PromQLAt): string;
+    protected printBinaryExpression(node: PromQLBinaryExpression): string;
+    protected printModifier(node: PromQLModifier): string;
+    protected printGroupModifier(node: PromQLGroupModifier): string;
+    protected formatOperator(op: string): string;
+    protected printUnaryExpression(node: PromQLUnaryExpression): string;
+    protected printSubquery(node: PromQLSubquery): string;
+    protected printParens(node: PromQLParens): string;
+    protected printLiteral(node: PromQLLiteral): string;
+    protected printIntegerLiteral(node: PromQLNumericLiteral): string;
+    protected printDecimalLiteral(node: PromQLNumericLiteral): string;
+    protected printHexLiteral(node: PromQLNumericLiteral): string;
+    protected printStringLiteral(node: PromQLStringLiteral): string;
+    protected printTimeLiteral(node: PromQLTimeValue): string;
+    protected printIdentifier(node: PromQLIdentifier): string;
+}
+//# sourceMappingURL=basic_pretty_printer.d.ts.map

package/lib/embedded_languages/promql/pretty_print/basic_pretty_printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic_pretty_printer.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/pretty_print/basic_pretty_printer.ts"],"names":[],"mappings":"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"}

package/lib/embedded_languages/promql/pretty_print/helpers.d.ts

@@ -0,0 +1,34 @@
+import type { PromQLAstExpression, PromQLBinaryOperator } from '../types';
+/**
+ * Precedence groups for PromQL binary operators. Higher numeric value means
+ * tighter binding.
+ */
+export declare enum PromQLPrecedenceGroup {
+    none = 0,
+    or = 1,
+    andUnless = 2,
+    comparison = 3,
+    additive = 4,
+    multiplicative = 5,
+    power = 6
+}
+/**
+ * Returns the precedence group for a PromQL AST expression node. Non-binary
+ * expressions return `PromQLPrecedenceGroup.none`.
+ */
+export declare const promqlBinaryPrecedenceGroup: (node: PromQLAstExpression) => PromQLPrecedenceGroup;
+/**
+ * Returns whether a PromQL binary operator is right-associative.
+ *
+ * In PromQL, `^` (power/exponentiation) is the **only** right-associative
+ * binary operator. All others (`+`, `-`, `*`, `/`, `%`, comparisons, `and`,
+ * `or`, `unless`) are left-associative.
+ *
+ * This matters for parens insertion of same-precedence children:
+ *
+ * - Right-associative: the **left** child needs parens to override natural
+ *   grouping (`(a ^ b) ^ c` — without parens it would be `a ^ (b ^ c)`).
+ * - Left-associative: the **right** child needs parens (`a - (b + c)`).
+ */
+export declare const isPromQLRightAssociative: (op: PromQLBinaryOperator) => boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/embedded_languages/promql/pretty_print/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/pretty_print/helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAE1E;;;GAGG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,IAAI;IACR,EAAE,IAAI;IACN,SAAS,IAAI;IACb,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,cAAc,IAAI;IAClB,KAAK,IAAI;CACV;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM,mBAAmB,KAAG,qBA8BvE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GAAI,IAAI,oBAAoB,KAAG,OAAqB,CAAC"}

package/lib/embedded_languages/promql/pretty_print/index.d.ts

@@ -0,0 +1,2 @@
+export { PromQLBasicPrettyPrinter, type PromQLBasicPrettyPrinterOptions, } from './basic_pretty_printer';
+//# sourceMappingURL=index.d.ts.map

package/lib/embedded_languages/promql/pretty_print/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/embedded_languages/promql/pretty_print/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,wBAAwB,CAAC"}

package/lib/embedded_languages/promql/types.d.ts

@@ -0,0 +1,355 @@
+import type { ESQLLocation, EditorError, ESQLAstBaseItem } from '../../types';
+/**
+ * All PromQL AST nodes have a `dialect: 'promql'` property to distinguish them
+ * from ES|QL AST nodes.
+ */
+export interface PromQLAstNodeBase<Name = string> extends ESQLAstBaseItem<Name> {
+    dialect: 'promql';
+    name: Name;
+    text: string;
+    location: ESQLLocation;
+    incomplete: boolean;
+}
+/**
+ * Represents a complete PromQL query expression.
+ */
+export interface PromQLAstQueryExpression extends PromQLAstNodeBase<''> {
+    type: 'query';
+    /**
+     * The main expression of the query. May be undefined for incomplete queries.
+     */
+    expression?: PromQLAstExpression;
+}
+/**
+ * All possible PromQL expressions.
+ */
+export type PromQLAstExpression = PromQLFunction | PromQLSelector | PromQLBinaryExpression | PromQLUnaryExpression | PromQLSubquery | PromQLParens | PromQLLiteral | PromQLIdentifier | PromQLUnknownItem;
+/**
+ * A PromQL AST node.
+ */
+export type PromQLAstNode = PromQLAstQueryExpression | PromQLAstExpression | PromQLGrouping | PromQLLabelMap | PromQLLabel | PromQLEvaluation | PromQLOffset | PromQLAt | PromQLModifier | PromQLGroupModifier;
+/**
+ * Represents a PromQL function call.
+ *
+ * ```promql
+ * rate(http_requests_total[5m])
+ * sum by (job) (rate(http_requests_total[5m]))
+ * avg (cpu_usage) without (instance)
+ * ```
+ */
+export interface PromQLFunction extends PromQLAstNodeBase {
+    type: 'function';
+    /**
+     * Function arguments, with at least one argument, unless the
+     * function is incomplete.
+     */
+    args: PromQLAstExpression[];
+    /**
+     * Optional grouping clause (BY or WITHOUT).
+     */
+    grouping?: PromQLGrouping;
+    /**
+     * Position of the grouping clause relative to the function arguments.
+     *
+     * - `'before'`: `sum by (job) (...)` - grouping appears before the arguments
+     * - `'after'`: `sum(...) by (job)` - grouping appears after the arguments
+     *
+     * Only set when `grouping` is defined.
+     */
+    groupingPosition?: 'before' | 'after';
+}
+/**
+ * Represents grouping modifiers in aggregation functions.
+ *
+ * ```promql
+ * sum by (job, instance) (...)
+ * avg (...) without (cpu)
+ * ```
+ */
+export interface PromQLGrouping extends PromQLAstNodeBase<'by' | 'without'> {
+    type: 'grouping';
+    args: PromQLLabelName[];
+}
+/**
+ * Represents a label matcher in a selector.
+ *
+ * ```promql
+ * {job="api", status=~"5.."}
+ * ```
+ */
+export interface PromQLLabel extends PromQLAstNodeBase {
+    type: 'label';
+    /**
+     * The label name.
+     */
+    labelName: PromQLLabelName;
+    /**
+     * The match operator: =, !=, =~, !~
+     */
+    operator: PromQLLabelMatchOperator;
+    /**
+     * The label value (string literal).
+     */
+    value?: PromQLStringLiteral;
+}
+export type PromQLLabelMatchOperator = '=' | '!=' | '=~' | '!~';
+/**
+ * Represents a label name which can be an identifier, string, or number.
+ */
+export type PromQLLabelName = PromQLIdentifier | PromQLStringLiteral | PromQLNumericLiteral;
+/**
+ * Represents the label map (curly braces with label matchers) in a selector.
+ *
+ * ```promql
+ * {}
+ * {job="api"}
+ * {job="api", status=~"5.."}
+ * ```
+ */
+export interface PromQLLabelMap extends PromQLAstNodeBase<''> {
+    type: 'label-map';
+    /**
+     * The label matchers inside the curly braces.
+     */
+    args: PromQLLabel[];
+}
+/**
+ * Represents a PromQL selector (instant vector or range vector).
+ *
+ * @example
+ * ```promql
+ * {}
+ * {label1="value1"}
+ * {label1="value1", label2!="value2"}
+ * {label1="value1", label2!="value2"}[]
+ * {label1="value1", label2!="value2"}[5m]
+ * http_requests_total
+ * http_requests_total{}
+ * http_requests_total{label="value", label2!="value2"}
+ * http_requests_total{job="api"}[]
+ * http_requests_total{job="api"}[5m]
+ * http_requests_total{job="api"}[5m] offset - 5m
+ * http_requests_total{job="api"}[5m] offset - 123 at - 5m
+ * ```
+ */
+export interface PromQLSelector extends PromQLAstNodeBase {
+    type: 'selector';
+    /**
+     * The metric name (can be empty for label-only selectors).
+     */
+    metric?: PromQLIdentifier;
+    /**
+     * Label map containing label matchers in curly braces.
+     */
+    labelMap?: PromQLLabelMap;
+    /**
+     * Optional range duration in square brackets.
+     * Makes this a range vector selector.
+     */
+    duration?: PromQLAstExpression;
+    /**
+     * Optional evaluation modifiers (offset and @).
+     */
+    evaluation?: PromQLEvaluation;
+    /**
+     * All children of the selector in order: [metric?, labelMap?, duration?, evaluation?].
+     * Undefined elements are not included in the array.
+     */
+    args: Array<PromQLIdentifier | PromQLLabelMap | PromQLAstExpression | PromQLEvaluation>;
+}
+/**
+ * Represents evaluation modifiers: offset and @ timestamp.
+ *
+ * ```promql
+ * http_requests_total offset 5m
+ * http_requests_total @ 1609459200
+ * http_requests_total offset 5m @ 1609459200
+ * ```
+ */
+export interface PromQLEvaluation extends PromQLAstNodeBase<'evaluation'> {
+    type: 'evaluation';
+    offset?: PromQLOffset;
+    at?: PromQLAt;
+}
+/**
+ * Represents an offset modifier.
+ *
+ * ```promql
+ * offset 5m
+ * offset -5m
+ * ```
+ */
+export interface PromQLOffset extends PromQLAstNodeBase<'offset'> {
+    type: 'offset';
+    negative: boolean;
+    duration: PromQLAstExpression;
+}
+/**
+ * Represents an @ timestamp modifier.
+ *
+ * ```promql
+ * @ 1609459200
+ * @ start()
+ * @ end()
+ * ```
+ */
+export interface PromQLAt extends PromQLAstNodeBase<'at'> {
+    type: 'at';
+    negative: boolean;
+    value: PromQLTimeValue | PromQLAtModifier;
+}
+export type PromQLAtModifier = 'start()' | 'end()';
+/**
+ * Represents a binary expression in PromQL.
+ *
+ * ```promql
+ * a + b
+ * a == bool b
+ * a * on(job) b
+ * ```
+ */
+export interface PromQLBinaryExpression<Name extends PromQLBinaryOperator = PromQLBinaryOperator> extends PromQLAstNodeBase<Name> {
+    type: 'binary-expression';
+    left: PromQLAstExpression;
+    right: PromQLAstExpression;
+    /**
+     * For comparison operators, whether BOOL modifier is present.
+     */
+    bool?: boolean;
+    /**
+     * Optional vector matching modifier.
+     */
+    modifier?: PromQLModifier;
+}
+export type PromQLBinaryOperator = PromQLArithmeticOperator | PromQLComparisonOperator | PromQLSetOperator;
+export type PromQLArithmeticOperator = '+' | '-' | '*' | '/' | '%' | '^';
+export type PromQLComparisonOperator = '==' | '!=' | '>' | '>=' | '<' | '<=';
+export type PromQLSetOperator = 'and' | 'or' | 'unless';
+/**
+ * Represents vector matching modifiers.
+ *
+ * ```promql
+ * a + on(job) b
+ * a + ignoring(instance) group_left(job) b
+ * ```
+ */
+export interface PromQLModifier extends PromQLAstNodeBase<'on' | 'ignoring'> {
+    type: 'modifier';
+    labels: PromQLLabelName[];
+    groupModifier?: PromQLGroupModifier;
+}
+/**
+ * Represents group_left or group_right modifier.
+ */
+export interface PromQLGroupModifier extends PromQLAstNodeBase<'group_left' | 'group_right'> {
+    type: 'group-modifier';
+    labels: PromQLLabelName[];
+}
+/**
+ * Represents a unary expression in PromQL.
+ *
+ * ```promql
+ * -vector
+ * +vector
+ * ```
+ */
+export interface PromQLUnaryExpression extends PromQLAstNodeBase<'+' | '-'> {
+    type: 'unary-expression';
+    arg: PromQLAstExpression;
+}
+/**
+ * Represents a subquery expression.
+ *
+ * ```promql
+ * rate(http_requests_total[5m])[30m:1m]
+ * ```
+ */
+export interface PromQLSubquery extends PromQLAstNodeBase<'subquery'> {
+    type: 'subquery';
+    expr: PromQLAstExpression;
+    range: PromQLAstExpression;
+    resolution?: PromQLAstExpression;
+    evaluation?: PromQLEvaluation;
+}
+/**
+ * Represents a parenthesized expression.
+ *
+ * ```promql
+ * (a + b)
+ * ```
+ */
+export interface PromQLParens extends PromQLAstNodeBase<''> {
+    type: 'parens';
+    child: PromQLAstExpression;
+}
+export type PromQLLiteral = PromQLNumericLiteral | PromQLStringLiteral | PromQLTimeValue;
+/**
+ * Represents a numeric literal (integer, decimal, or hexadecimal).
+ */
+export interface PromQLNumericLiteral extends PromQLAstNodeBase {
+    type: 'literal';
+    literalType: 'integer' | 'decimal' | 'hexadecimal';
+    value: number;
+}
+/**
+ * Represents a string literal.
+ */
+export interface PromQLStringLiteral extends PromQLAstNodeBase {
+    type: 'literal';
+    literalType: 'string';
+    value: string;
+    valueUnquoted: string;
+}
+/**
+ * Represents a time/duration value.
+ *
+ * ```promql
+ * 5m
+ * 1h30m
+ * :5m
+ * ```
+ */
+export interface PromQLTimeValue extends PromQLAstNodeBase {
+    type: 'literal';
+    literalType: 'time';
+    value: string;
+}
+/**
+ * Represents an identifier (metric name, label name, function name).
+ */
+export interface PromQLIdentifier extends PromQLAstNodeBase {
+    type: 'identifier';
+}
+/**
+ * Represents an unknown or unrecognized item in the AST.
+ */
+export interface PromQLUnknownItem extends PromQLAstNodeBase<'unknown'> {
+    type: 'unknown';
+}
+/**
+ * Result of parsing a PromQL query.
+ */
+export interface PromQLParseResult<T extends PromQLAstNode = PromQLAstQueryExpression> {
+    /**
+     * The root node of the parsed tree.
+     */
+    root: T;
+    /**
+     * List of parsing errors.
+     */
+    errors: EditorError[];
+}
+/**
+ * Result of PromQL AST position detection (via PromqlWalker).
+ */
+export interface PromQLPositionResult {
+    /**
+     * The deepest node containing the offset.
+     */
+    node: PromQLAstNode | undefined;
+    /**
+     * Parent node of the current node.
+     */
+    parent: PromQLAstNode | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/embedded_languages/promql/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/embedded_languages/promql/types.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+export * from './parser';
+export * from './ast';
+export * from './composer';
+export * from './pretty_print';
+export * from './embedded_languages';
+export * from './debug';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC"}