@vaultgradient/pipequery-lang 1.2.2

package/dist/engine/index.d.cts

@@ -0,0 +1,203 @@
+interface NumberLiteral {
+    kind: 'NumberLiteral';
+    value: number;
+}
+interface StringLiteral {
+    kind: 'StringLiteral';
+    value: string;
+}
+interface BooleanLiteral {
+    kind: 'BooleanLiteral';
+    value: boolean;
+}
+interface NullLiteral {
+    kind: 'NullLiteral';
+}
+interface FieldAccess {
+    kind: 'FieldAccess';
+    path: string[];
+}
+interface BinaryExpr {
+    kind: 'BinaryExpr';
+    operator: '>' | '>=' | '<' | '<=' | '==' | '!=' | '&&' | '||' | '+' | '-' | '*' | '/' | '%';
+    left: Expression;
+    right: Expression;
+}
+interface UnaryExpr {
+    kind: 'UnaryExpr';
+    operator: '!' | '-';
+    operand: Expression;
+}
+interface FunctionCall {
+    kind: 'FunctionCall';
+    name: string;
+    args: Expression[];
+}
+interface AliasExpr {
+    kind: 'AliasExpr';
+    expression: Expression;
+    alias: string;
+}
+type Expression = NumberLiteral | StringLiteral | BooleanLiteral | NullLiteral | FieldAccess | BinaryExpr | UnaryExpr | FunctionCall | AliasExpr;
+interface WhereOp {
+    kind: 'WhereOp';
+    condition: Expression;
+}
+interface SelectOp {
+    kind: 'SelectOp';
+    fields: Expression[];
+}
+interface SortOp {
+    kind: 'SortOp';
+    criteria: Array<{
+        expression: Expression;
+        direction: 'asc' | 'desc';
+    }>;
+}
+interface GroupByOp {
+    kind: 'GroupByOp';
+    keys: Expression[];
+}
+interface JoinOp {
+    kind: 'JoinOp';
+    right: string;
+    condition: Expression;
+}
+interface FirstOp {
+    kind: 'FirstOp';
+    count: number;
+}
+interface LastOp {
+    kind: 'LastOp';
+    count: number;
+}
+interface DistinctOp {
+    kind: 'DistinctOp';
+    fields?: Expression[];
+}
+interface FlattenOp {
+    kind: 'FlattenOp';
+    field?: Expression;
+}
+type AggregateFnName = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'median' | 'stddev' | 'var' | 'percentile' | 'skew' | 'kurt' | 'vwap' | 'wavg' | 'drawdown' | 'pct' | 'sharpe' | 'calmar' | 'sortino' | 'info_ratio' | 'distinct_count' | 'sum_abs' | 'abs_sum' | 'first_value' | 'last_value';
+interface AggregateOp {
+    kind: 'AggregateOp';
+    function: AggregateFnName;
+    field?: Expression;
+    args?: Expression[];
+}
+interface RollupOp {
+    kind: 'RollupOp';
+    keys: Expression[];
+    aggregates: Expression[];
+}
+interface PivotOp {
+    kind: 'PivotOp';
+    pivotField: Expression;
+    aggregates: Expression[];
+}
+interface TransposeOp {
+    kind: 'TransposeOp';
+    headerField?: Expression;
+}
+interface MapOp {
+    kind: 'MapOp';
+    fields: Expression[];
+}
+interface ReduceOp {
+    kind: 'ReduceOp';
+    initial: Expression;
+    accumulator: Expression;
+}
+type Operation = WhereOp | SelectOp | SortOp | GroupByOp | JoinOp | FirstOp | LastOp | DistinctOp | FlattenOp | AggregateOp | RollupOp | PivotOp | TransposeOp | MapOp | ReduceOp;
+interface Pipeline {
+    kind: 'Pipeline';
+    source: string;
+    operations: Operation[];
+}
+declare class DataWeaveError extends Error {
+    position: number;
+    line: number;
+    column: number;
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class LexerError extends DataWeaveError {
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class ParseError extends DataWeaveError {
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class RuntimeError extends Error {
+    constructor(message: string);
+}
+type DataContext = Record<string, unknown[]>;
+type RowData = Record<string, unknown>;
+interface CompiledQuery {
+    (context: DataContext): unknown;
+    source: string;
+    ast: Pipeline;
+}
+
+interface LiveQueryOptions {
+    /** Field name(s) used as the unique key for delta merges */
+    key: string | string[];
+    /** Which source in a DataContext receives patches (defaults to '_data' for raw arrays) */
+    source?: string;
+    /** Minimum ms between executions. 0 = next microtask (default: 0) */
+    throttle?: number;
+}
+interface LiveQueryStats {
+    patchMs: number;
+    executionMs: number;
+    totalMs: number;
+    rowCount: number;
+    resultCount: number;
+    patchCount: number;
+    tick: number;
+}
+type LiveQuerySubscriber = (result: unknown, stats: LiveQueryStats) => void;
+type RemovalKey = string | string[];
+declare class LiveQuery {
+    private _index;
+    private _keyFields;
+    private _sourceName;
+    private _context;
+    private _compiled;
+    private _throttle;
+    private _pendingTimer;
+    private _executing;
+    private _dirtyDuringExec;
+    private _result;
+    private _stats;
+    private _subscribers;
+    private _batchDepth;
+    private _batchDirty;
+    private _disposed;
+    constructor(data: RowData[] | DataContext, expression: string, options: LiveQueryOptions);
+    get result(): unknown;
+    get stats(): LiveQueryStats;
+    get size(): number;
+    subscribe(fn: LiveQuerySubscriber): () => void;
+    patch(changed: RowData[], removals?: RemovalKey[]): void;
+    reset(data: RowData[]): void;
+    setQuery(expression: string): void;
+    beginBatch(): void;
+    endBatch(): void;
+    dispose(): void;
+    private _rowKey;
+    private _removalKey;
+    private _buildIndex;
+    private _scheduleExecution;
+    private _onTimer;
+    private _executeSync;
+    private _notify;
+    private _guardDisposed;
+}
+declare function liveQuery(data: RowData[] | DataContext, expression: string, options: LiveQueryOptions): LiveQuery;
+
+declare function compile(expression: string, useCache?: boolean): CompiledQuery;
+declare function query(context: DataContext | RowData[], expression: string): unknown;
+declare function parseQuery(expression: string): Pipeline;
+declare function clearCache(): void;
+
+export { type CompiledQuery, type DataContext, DataWeaveError, type Expression, LexerError, LiveQuery, type LiveQueryOptions, type LiveQueryStats, type LiveQuerySubscriber, type Operation, ParseError, type Pipeline, RuntimeError, clearCache, compile, liveQuery, parseQuery, query };

package/dist/engine/index.d.ts

@@ -0,0 +1,203 @@
+interface NumberLiteral {
+    kind: 'NumberLiteral';
+    value: number;
+}
+interface StringLiteral {
+    kind: 'StringLiteral';
+    value: string;
+}
+interface BooleanLiteral {
+    kind: 'BooleanLiteral';
+    value: boolean;
+}
+interface NullLiteral {
+    kind: 'NullLiteral';
+}
+interface FieldAccess {
+    kind: 'FieldAccess';
+    path: string[];
+}
+interface BinaryExpr {
+    kind: 'BinaryExpr';
+    operator: '>' | '>=' | '<' | '<=' | '==' | '!=' | '&&' | '||' | '+' | '-' | '*' | '/' | '%';
+    left: Expression;
+    right: Expression;
+}
+interface UnaryExpr {
+    kind: 'UnaryExpr';
+    operator: '!' | '-';
+    operand: Expression;
+}
+interface FunctionCall {
+    kind: 'FunctionCall';
+    name: string;
+    args: Expression[];
+}
+interface AliasExpr {
+    kind: 'AliasExpr';
+    expression: Expression;
+    alias: string;
+}
+type Expression = NumberLiteral | StringLiteral | BooleanLiteral | NullLiteral | FieldAccess | BinaryExpr | UnaryExpr | FunctionCall | AliasExpr;
+interface WhereOp {
+    kind: 'WhereOp';
+    condition: Expression;
+}
+interface SelectOp {
+    kind: 'SelectOp';
+    fields: Expression[];
+}
+interface SortOp {
+    kind: 'SortOp';
+    criteria: Array<{
+        expression: Expression;
+        direction: 'asc' | 'desc';
+    }>;
+}
+interface GroupByOp {
+    kind: 'GroupByOp';
+    keys: Expression[];
+}
+interface JoinOp {
+    kind: 'JoinOp';
+    right: string;
+    condition: Expression;
+}
+interface FirstOp {
+    kind: 'FirstOp';
+    count: number;
+}
+interface LastOp {
+    kind: 'LastOp';
+    count: number;
+}
+interface DistinctOp {
+    kind: 'DistinctOp';
+    fields?: Expression[];
+}
+interface FlattenOp {
+    kind: 'FlattenOp';
+    field?: Expression;
+}
+type AggregateFnName = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'median' | 'stddev' | 'var' | 'percentile' | 'skew' | 'kurt' | 'vwap' | 'wavg' | 'drawdown' | 'pct' | 'sharpe' | 'calmar' | 'sortino' | 'info_ratio' | 'distinct_count' | 'sum_abs' | 'abs_sum' | 'first_value' | 'last_value';
+interface AggregateOp {
+    kind: 'AggregateOp';
+    function: AggregateFnName;
+    field?: Expression;
+    args?: Expression[];
+}
+interface RollupOp {
+    kind: 'RollupOp';
+    keys: Expression[];
+    aggregates: Expression[];
+}
+interface PivotOp {
+    kind: 'PivotOp';
+    pivotField: Expression;
+    aggregates: Expression[];
+}
+interface TransposeOp {
+    kind: 'TransposeOp';
+    headerField?: Expression;
+}
+interface MapOp {
+    kind: 'MapOp';
+    fields: Expression[];
+}
+interface ReduceOp {
+    kind: 'ReduceOp';
+    initial: Expression;
+    accumulator: Expression;
+}
+type Operation = WhereOp | SelectOp | SortOp | GroupByOp | JoinOp | FirstOp | LastOp | DistinctOp | FlattenOp | AggregateOp | RollupOp | PivotOp | TransposeOp | MapOp | ReduceOp;
+interface Pipeline {
+    kind: 'Pipeline';
+    source: string;
+    operations: Operation[];
+}
+declare class DataWeaveError extends Error {
+    position: number;
+    line: number;
+    column: number;
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class LexerError extends DataWeaveError {
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class ParseError extends DataWeaveError {
+    constructor(message: string, position: number, line: number, column: number);
+}
+declare class RuntimeError extends Error {
+    constructor(message: string);
+}
+type DataContext = Record<string, unknown[]>;
+type RowData = Record<string, unknown>;
+interface CompiledQuery {
+    (context: DataContext): unknown;
+    source: string;
+    ast: Pipeline;
+}
+
+interface LiveQueryOptions {
+    /** Field name(s) used as the unique key for delta merges */
+    key: string | string[];
+    /** Which source in a DataContext receives patches (defaults to '_data' for raw arrays) */
+    source?: string;
+    /** Minimum ms between executions. 0 = next microtask (default: 0) */
+    throttle?: number;
+}
+interface LiveQueryStats {
+    patchMs: number;
+    executionMs: number;
+    totalMs: number;
+    rowCount: number;
+    resultCount: number;
+    patchCount: number;
+    tick: number;
+}
+type LiveQuerySubscriber = (result: unknown, stats: LiveQueryStats) => void;
+type RemovalKey = string | string[];
+declare class LiveQuery {
+    private _index;
+    private _keyFields;
+    private _sourceName;
+    private _context;
+    private _compiled;
+    private _throttle;
+    private _pendingTimer;
+    private _executing;
+    private _dirtyDuringExec;
+    private _result;
+    private _stats;
+    private _subscribers;
+    private _batchDepth;
+    private _batchDirty;
+    private _disposed;
+    constructor(data: RowData[] | DataContext, expression: string, options: LiveQueryOptions);
+    get result(): unknown;
+    get stats(): LiveQueryStats;
+    get size(): number;
+    subscribe(fn: LiveQuerySubscriber): () => void;
+    patch(changed: RowData[], removals?: RemovalKey[]): void;
+    reset(data: RowData[]): void;
+    setQuery(expression: string): void;
+    beginBatch(): void;
+    endBatch(): void;
+    dispose(): void;
+    private _rowKey;
+    private _removalKey;
+    private _buildIndex;
+    private _scheduleExecution;
+    private _onTimer;
+    private _executeSync;
+    private _notify;
+    private _guardDisposed;
+}
+declare function liveQuery(data: RowData[] | DataContext, expression: string, options: LiveQueryOptions): LiveQuery;
+
+declare function compile(expression: string, useCache?: boolean): CompiledQuery;
+declare function query(context: DataContext | RowData[], expression: string): unknown;
+declare function parseQuery(expression: string): Pipeline;
+declare function clearCache(): void;
+
+export { type CompiledQuery, type DataContext, DataWeaveError, type Expression, LexerError, LiveQuery, type LiveQueryOptions, type LiveQueryStats, type LiveQuerySubscriber, type Operation, ParseError, type Pipeline, RuntimeError, clearCache, compile, liveQuery, parseQuery, query };