API Reference

AbstractExpression

Internal runtime base class for parser node implementations (Identifier, Member, Binary, Function, and others). It owns bind/evaluate lifecycle and commit wiring.

Source: expressions/abstract-expression.ts

IExpression

Description

Provides common expression-tree behavior: child-parent hierarchy, bind lifecycle, value storage, change emission, and transaction-manager integration.

Parameters

Tgeneric type parameter

Current node evaluation result type.

PTgeneric type parameter

Parent expression value type.

settingsIExpressionBindConfiguration

Services/owner/rules used to bind an expression to a model context.

Return type

bind(...) returns the bound AbstractExpression instance.

evaluate(...) returns T | undefined.

API

export abstract class AbstractExpression<T = unknown, PT = unknown>
  implements IExpression<T> {
  public abstract clone(): this;
  public bind(settings: IExpressionBindConfiguration): AbstractExpression;
  protected abstract evaluate(
    sender: AbstractExpression,
    root: AbstractExpression,
  ): T | undefined;
}

Usage example

import { rsx } from '@rs-x/expression-parser';

const model = { a: 10, b: 20 };
const expression = rsx<number>('a + b')(model);

// In application code you usually consume IExpression,
// while runtime internals use AbstractExpression subclasses.
console.log(expression.value);