Class ParserRuntimeFeaturePolicy

Namespace

Utils.Parser.Runtime

Assembly

Utils.Parser.dll

Immutable runtime feature policy used by parser components to centralize optional runtime strategies such as semantic predicate evaluation and parser action execution. The policy can affect branch acceptance and action execution, but does not change parser scheduling mechanics.

public sealed record ParserRuntimeFeaturePolicy : IEquatable<ParserRuntimeFeaturePolicy>

Inheritance

object

ParserRuntimeFeaturePolicy

Implements

IEquatable<ParserRuntimeFeaturePolicy>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DataUtils.ToDbValue(object?)

MathEx.Clamp<T>(T, T, T, IComparer<T>)

FluentExtensions.Failure<T>(T)

FluentExtensions.IsEqualTo<T, CT>(T, CT)

FluentExtensions.IsGreaterOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsGreaterThan<T, CT>(T, CT)

FluentExtensions.IsIn<T>(T, params T[])

FluentExtensions.IsLowerOrEqualsThan<T, CT>(T, CT)

FluentExtensions.IsLowerThan<T, CT>(T, CT)

FluentExtensions.IsNotIn<T>(T, params T[])

FluentExtensions.IsNotNull<T>(T)

FluentExtensions.IsNull<T>(T)

FluentExtensions.Success<T>(T)

FluentExtensions.Test<T>(T, Func<T, bool>)

ObjectUtils.Between<T>(T, IComparer<T>, T, T)

ObjectUtils.Between<T>(T, IComparer<T>, T, T, bool, bool)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Func<Task<Result>>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Task<Result>>, Result)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.DoAsync<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Func<Result>)

ObjectUtils.Do<T, Result>(T, Func<T, Result>, Result)

ObjectUtils.In<T>(T, params T[])

ObjectUtils.NotIn<T>(T, params T[])

Validations.ArgMustBe<T>(T, Func<T, bool>, string, string)

Validations.ArgMustNotBe<T>(T, Func<T, bool>, string, string)

Validations.Arg<T>(T, string)

Validations.ValueMustNotBeNull<T>(T, string)

Validations.Variable<T>(T, string)

Properties

Default

Gets the conservative default runtime policy. Semantic predicates are not evaluated, parser actions are not executed, and rule lifecycle hooks are not invoked.

public static ParserRuntimeFeaturePolicy Default { get; }

Property Value

ParserRuntimeFeaturePolicy

EmbeddedCodeTransformer

Gets the embedded-code transformer that dynamic embedded-code preparation paths apply before invoking their configured compiler. The default transformer preserves code unchanged.

public IParserEmbeddedCodeTransformer EmbeddedCodeTransformer { get; init; }

Property Value

IParserEmbeddedCodeTransformer

ExecutionStateManager

Gets the parser execution-state manager used to expose opaque semantic state snapshots and memoization keys. ParserEngine reads state keys for completed-result memoization and invokes capture/restore around managed parser attempt boundaries.

public required IParserExecutionStateManager ExecutionStateManager { get; init; }

Property Value

IParserExecutionStateManager

LexerActionExecutor

Gets the lexer action execution strategy. The default no-op executor preserves conservative lexer behavior.

public required ILexerActionExecutor LexerActionExecutor { get; init; }

Property Value

ILexerActionExecutor

LexerPredicateEvaluator

Gets the lexer predicate evaluation strategy. The default no-op evaluator preserves conservative lexer behavior.

public required ILexerPredicateEvaluator LexerPredicateEvaluator { get; init; }

Property Value

ILexerPredicateEvaluator

ParserActionExecutor

Gets the parser action execution strategy.

public required IParserActionExecutor ParserActionExecutor { get; init; }

Property Value

IParserActionExecutor

RuleCallExecutionPolicy

Gets the explicit parser rule-call execution policy invoked around parser rule references. The default no-op policy preserves metadata-only call arguments and labels.

public IParserRuleCallExecutionPolicy RuleCallExecutionPolicy { get; init; }

Property Value

IParserRuleCallExecutionPolicy

RuleInvocationFrameManager

Gets the parser rule invocation-frame manager used to create passive per-rule metadata frames. The default no-op manager does not execute parameters, locals, returns, or exception metadata.

public required IParserRuleInvocationFrameManager RuleInvocationFrameManager { get; init; }

Property Value

IParserRuleInvocationFrameManager

RuleLifecycleExecutor

Gets the parser rule lifecycle executor that handles @init and @after hooks. The default no-op executor skips lifecycle hooks and preserves conservative behavior.

public required IParserRuleLifecycleExecutor RuleLifecycleExecutor { get; init; }

Property Value

IParserRuleLifecycleExecutor

RuntimeObserver

Gets the optional passive runtime observer for scheduling introspection. This observer is descriptive-only and does not control parser execution.

public IParserRuntimeObserver? RuntimeObserver { get; init; }

Property Value

IParserRuntimeObserver

SemanticPredicateEvaluator

Gets the semantic predicate evaluation strategy.

public required ISemanticPredicateEvaluator SemanticPredicateEvaluator { get; init; }

Property Value

ISemanticPredicateEvaluator